ai-search/
llm-mentions

Trouvez les AI Overviews et réponses ChatGPT qui citent un domaine ou mentionnent un mot-clé, avec la question, la réponse complète en Markdown, les sources citées et le volume de recherche IA mensuel.

LLM Mentions API

AI Overviews et ChatGPT
Réponse complète
Sources citées
Volume de recherche IA
40 crédits par requête + 0,5 crédit par résultat
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
targetObligatoire (au moins un)Domaine à suivre dans les réponses IA, par exemple hubspot.com, sans chemin de page. Envoyez target ou query.
queryObligatoire (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.
platformFacultatifgoogle 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_codeFacultatifCode de localisation du marché. Par défaut 2840 (États-Unis), le marché couvert par les réponses chat_gpt.
location_nameFacultatifNom du marché, à la place de location_code. S’il est renseigné, il remplace location_code.
language_codeFacultatifCode de langue des réponses. Par défaut en, la langue des réponses chat_gpt.
languageFacultatifNom de la langue, à la place de language_code. S’il est renseigné, il remplace language_code.
results_limitFacultatifNombre 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.

  1. Envoyez {"target": "notion.so", "platform": "google", "results_limit": 100} en POST à /v1/ai-search/llm-mentions.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. 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.

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.

Explorer d’autres plateformes

Combinez les données AI Search avec les données publiques d’autres plateformes sociales prises en charge.

LLM Mentions API — FAQ

LLM Mentions API renvoie, pour un domaine ou un mot-clé, les AI Overviews de Google et les réponses de ChatGPT qui citent ce domaine ou mentionnent ce mot-clé. Chaque ligne contient la question, la réponse complète, les sources citées, le modèle et le volume de recherche IA mensuel de la question.

platform google lit Google AI Overviews dans le marché choisi, et platform chat_gpt lit les réponses de ChatGPT pour les États-Unis en anglais.

target avec un domaine trouve les réponses qui citent ce site ; query avec un mot-clé ou un nom de marque trouve celles qui le mentionnent. Chaque requête utilise l’un des deux.

Les noms de marque, les résultats web consultés et les recherches complémentaires sont enregistrés pour les réponses de ChatGPT ; réglez platform sur chat_gpt pour les obtenir.

Chaque requête coûte 40 crédits plus 0,5 crédit par réponse renvoyée, et les 40 crédits s’appliquent aussi lorsqu’aucune réponse ne correspond.