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ètres | Obligatoire | Description |
|---|---|---|
target | Obligatoire (au moins un) | Domaine à mesurer, par exemple hubspot.com, sans chemin de page. Envoyez target ou query. |
query | Obligatoire (au moins un) | Mot-clé, nom de marque ou thème à mesurer, par exemple crm software. 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 et ajoute des lignes de marques. |
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. |
Comment utiliser la AI Search Visibility API
Envoyez un domaine ou un mot-clé et lisez le total puis chaque ventilation.
- Envoyez {"target": "hubspot.com", "platform": "chat_gpt"} en POST à /v1/ai-search/llm-brand-metrics.
- Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
- 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.
API associées
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.