ai-search/
llm-brand-metrics

Comptez combien de réponses de Google AI Overviews ou de ChatGPT mentionnent un domaine ou un mot-clé, avec leur volume de recherche IA cumulé, les domaines qu’elles citent le plus et les marques qui apparaissent à côté.

AI Search Visibility API

Part de voix
Domaines cités
Marques citées à côté
AI Overviews et ChatGPT
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

AI Search Visibility

La visibilité dans la recherche IA mesure la place d’une marque dans les réponses générées par l’IA : combien de réponses de Google AI Overviews ou de ChatGPT la mentionnent ou la citent, quelle demande mensuelle se cache derrière ces questions, sur quels sites ces réponses s’appuient et quelles autres marques sont nommées dans la foulée. Mesurée côte à côte pour une marque et ses concurrents, elle montre qui l’IA recommande dans une catégorie, quels éditeurs pèsent sur cette recommandation et si la visibilité progresse après un travail de contenu ou de relations presse.

Fonctionnalités de la AI Search Visibility API

  • Un total pour toute la présenceLa ligne total donne mentions_count, le nombre de réponses IA qui mentionnent ou citent le domaine ou le mot-clé, et ai_search_volume, la demande mensuelle cumulée derrière leurs questions.
  • Les domaines cités par les réponsesLes lignes source_domain classent les 10 sites que ces réponses citent le plus et montrent quels éditeurs façonnent ce que l’IA dit de vous.
  • Les domaines des résultats web lus par l’IALes lignes search_result_domain classent les sites apparus dans les résultats web consultés par l’IA avant de répondre, autrement dit la liste de lecture derrière les réponses.
  • Marques et catégories citées à vos côtésSur chat_gpt, les lignes brand et brand_category listent les marques et catégories de produits présentes dans les mêmes réponses, pour voir directement à qui l’on vous compare.
  • Un domaine ou un mot-clé comme sujetMesurez un site via target, ou un nom de produit, une catégorie ou un thème via query, sur AI Overviews comme sur ChatGPT.

Paramètres de la AI Search Visibility API

ParamètresObligatoireDescription
targetObligatoire (au moins un)Domaine à mesurer, par exemple hubspot.com, sans chemin de page. Envoyez target ou query.
queryObligatoire (au moins un)Mot-clé, nom de marque ou thème à mesurer, par exemple crm software. 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 et ajoute des lignes de marques.
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.

Comment utiliser la AI Search Visibility API

Envoyez un domaine ou un mot-clé et lisez le total puis chaque ventilation.

  1. Envoyez {"target": "hubspot.com", "platform": "chat_gpt"} en POST à /v1/ai-search/llm-brand-metrics.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. Lisez results.items en regroupant par dimension : d’abord total, puis source_domain, search_result_domain, brand et brand_category dans l’ordre de rank.
curl -X POST "https://api.socq.ai/v1/ai-search/llm-brand-metrics" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"hubspot.com","platform":"chat_gpt"}'

Cas d’usage de la AI Search Visibility API

  • Comparer sa part de voix IA à celle des concurrents : Interrogez votre domaine et deux concurrents sur la même plateforme et comparez mentions_count et ai_search_volume des lignes total pour voir qui l’IA cite le plus souvent.
  • Identifier les éditeurs derrière votre présence IA : Choisissez grâce aux lignes source_domain les sites de tests, médias et communautés à solliciter, car ce sont les pages sur lesquelles s’appuient les réponses IA qui vous mentionnent.
  • Suivre la visibilité après un lancement ou une campagne : Enregistrez régulièrement la ligne total et comparez-la avant et après un lancement produit, une action de relations presse ou une refonte de contenus.

Conseils d’expert pour la AI Search Visibility API

  • Si vous avez besoin des lignes brand et brand_category, réglez platform sur chat_gpt : les requêtes AI Overviews renvoient le total et les ventilations par domaine.
  • Pour comparer plusieurs marques, gardez la même plateforme, le même marché et la même langue afin que les totaux portent sur le même ensemble de réponses.
  • Si vous avez besoin des pages exactes plutôt que des domaines, appelez la LLM Top Sources API avec content_type sur pages pour le même target ou query.
  • Si la ligne total d’un domaine affiche peu de mentions, interrogez aussi le nom de marque en query, car une réponse peut nommer une marque sans lier son site.

En complément de la AI Search Visibility API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques AI Search.

  • LLM Mentions API — Trouvez les AI Overviews et réponses ChatGPT qui citent un domaine ou mentionnent un mot-clé, avec la réponse complète, les sources citées et le volume de recherche IA.
  • 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.

AI Search Visibility API — FAQ

AI Search Visibility API mesure la fréquence à laquelle les réponses de Google AI Overviews ou de ChatGPT mentionnent un domaine ou un mot-clé, avec le volume de recherche IA cumulé, les domaines cités et consultés et, sur ChatGPT, les marques et catégories nommées à côté.

Une ligne de total, puis jusqu’à 10 lignes par ventilation : domaines cités, domaines des résultats de recherche et, sur chat_gpt, marques et catégories de marques.

mentions_count est le nombre de réponses IA qui mentionnent ou citent ce domaine, cette marque ou cette catégorie, et ai_search_volume le volume de recherche IA mensuel cumulé des questions de ces réponses.

Chaque requête coûte 40 crédits plus 0,5 crédit par ligne renvoyée, et les 40 crédits s’appliquent aussi lorsqu’aucune réponse ne mentionne le domaine ou le mot-clé.