LLM Mentions
Une mention LLM est une question à laquelle Google AI Overviews ou ChatGPT répond en citant un domaine ou en reprenant un mot-clé, conservée avec la réponse complète, les pages citées, le modèle qui l’a produite et le nombre de fois où la question est posée chaque mois, ainsi que, pour ChatGPT, les marques nommées et les recherches complémentaires lancées. Lues côte à côte, ces réponses montrent sur quelles questions une marque apparaît aux utilisateurs d’IA, sur quelles sources les modèles s’appuient et où un produit est mal décrit, ce qui nourrit les audits GEO, la planification éditoriale et la comparaison avec les concurrents.
Fonctionnalités de la LLM Mentions API
- Un domaine ou un mot-clé comme point de départtarget cherche les réponses qui citent un domaine comme notion.so, query celles qui mentionnent un mot-clé ou un nom de marque, pour suivre à la fois votre site et la façon dont on parle de votre catégorie.
- La réponse telle que l’utilisateur la litanswer conserve la réponse entière en Markdown, avec titres, listes et liens intégrés, pour citer ou vérifier la formulation du modèle.
- Chaque page citéesources donne pour chaque page citée sa position, son titre, son URL, son domaine, le nom du site et un extrait, ce qui révèle quels contenus ont façonné la réponse.
- La demande derrière chaque questionai_search_volume estime le nombre de fois où la question est posée par mois, pour distinguer les mentions sur des questions très demandées de celles sur des questions rares.
- Marques, résultats web et recherches complémentaires sur ChatGPTAvec platform chat_gpt, brands liste les marques nommées dans l’ordre, search_results les pages consultées par ChatGPT et fan_out_queries les recherches supplémentaires qu’il a lancées.
- Date d’enregistrement des réponsesfirst_seen_at et last_seen_at datent chaque réponse et aident à séparer les réponses installées des réponses récentes.
Paramètres de la LLM Mentions API
| Paramètres | Obligatoire | Description |
|---|---|---|
target | Obligatoire (au moins un) | Domaine à suivre dans les réponses IA, par exemple hubspot.com, sans chemin de page. Envoyez target ou query. |
query | Obligatoire (au moins un) | Mot-clé ou nom de marque à suivre dans les réponses IA, par exemple crm software, jusqu’à 250 caractères. Envoyez target ou query. |
platform | Facultatif | google lit Google AI Overviews et sert de valeur par défaut ; chat_gpt lit les réponses de ChatGPT pour les États-Unis en anglais. |
location_code | Facultatif | Code de localisation du marché. Par défaut 2840 (États-Unis), le marché couvert par les réponses chat_gpt. |
location_name | Facultatif | Nom du marché, à la place de location_code. S’il est renseigné, il remplace location_code. |
language_code | Facultatif | Code de langue des réponses. Par défaut en, la langue des réponses chat_gpt. |
language | Facultatif | Nom de la langue, à la place de language_code. S’il est renseigné, il remplace language_code. |
results_limit | Facultatif | Nombre maximal de réponses, de 1 à 1000. Par défaut 100. |
Comment utiliser la LLM Mentions API
Envoyez un domaine ou un mot-clé et lisez une ligne par réponse IA.
- Envoyez {"target": "notion.so", "platform": "google", "results_limit": 100} en POST à /v1/ai-search/llm-mentions.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- Lisez les réponses dans results.items et demandez la page suivante avec results.next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/ai-search/llm-mentions" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target":"notion.so","platform":"google","results_limit":100}'Cas d’usage de la LLM Mentions API
- Auditer la présence d’un domaine dans les réponses IA : Passez votre domaine en target, triez par ai_search_volume et lisez answer et sources pour voir quelles questions très demandées vous citent et comment vous êtes décrit.
- Repérer les pages sur lesquelles l’IA s’appuie dans une catégorie : Utilisez un mot-clé de catégorie en query et comptez les domaines et URL de sources pour dresser la liste des articles à démarcher ou à surpasser.
- Comparer les marques dans les réponses de ChatGPT : Avec platform chat_gpt, interrogez votre marque et vos concurrents et comparez brands, avec la position de chacun, sur les mêmes questions.
- Planifier des contenus sur les angles absents : Rassemblez question et fan_out_queries des réponses où votre marque n’apparaît pas pour en tirer des briefs de pages que les modèles pourront citer.
Conseils d’expert pour la LLM Mentions API
- Interrogez une marque sous ses deux formes, le domaine en target et le nom en query, car la citation d’un site et la mention d’un nom renvoient des réponses différentes.
- Récupérez les réponses nécessaires en une seule requête avec un results_limit plus élevé, puisque la base de 40 crédits s’applique à chaque requête.
- Conservez l’id de chaque ligne et comparez last_seen_at au passage suivant pour distinguer les nouvelles réponses de celles déjà examinées.
API associées
En complément de la LLM Mentions API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques AI Search.
- AI Search Visibility API — Mesurez la fréquence à laquelle les réponses IA citent un domaine ou un mot-clé, avec le volume de recherche IA, les domaines les plus cités et, sur ChatGPT, les marques voisines.
- LLM Top Sources API — Classez les 10 domaines ou pages que AI Overviews et ChatGPT citent le plus pour un mot-clé ou un domaine, selon les mentions et le volume de recherche IA.
- Google AI Mode API — Récupérez la réponse complète de Google AI Mode pour une recherche, en Markdown, avec chaque source citée, dans le pays et la langue de votre choix.