AI SearchGEOMentions LLMGoogle AI ModeGuide API

API AI Search : suivre les mentions dans les LLM, la visibilité IA et les réponses de Google AI Mode

Quatre nouveaux endpoints SocQ AI Search renvoient les réponses AI Overviews et ChatGPT qui citent un domaine, la part de voix dans l’IA, les sources les plus citées et les réponses complètes de Google AI Mode.

SocQMis à jour le 19 novembre 20269 min de lecture

Si vous faites de l’optimisation pour les moteurs génératifs (GEO), vous avez besoin de données sur ce que disent les réponses de l’IA : quelles questions citent votre domaine, à quelle fréquence votre marque apparaît à côté de vos concurrents, à quels sites l’IA fait confiance dans votre catégorie et ce que l’AI Mode de Google écrit pour une recherche. Le 2026-11-17, SocQ a ajouté quatre endpoints pour cela sous la nouvelle plateforme AI Search. Ce guide présente ce que renvoie chacun d’eux, la requête, le prix et les cas d’usage.

Réponse rapide : envoyez un domaine (target) ou un mot-clé (query) à POST /v1/ai-search/llm-mentions, /llm-brand-metrics ou /llm-top-mentioned pour lire les réponses AI Overviews ou ChatGPT. Envoyez une recherche à POST /v1/ai-search/google-ai-mode pour obtenir une réponse AI Mode avec ses sources. Interrogez GET /v1/tasks/{task_id} pour récupérer les résultats.

1 crédit SocQ = $0,005.

EndpointCe qu’il renvoiePrix
LLM Mentions APIUne ligne par réponse IA qui cite un domaine ou mentionne un mot-clé : la question, la réponse complète en Markdown, les sources citées et le volume de recherche IA40 crédits ($0,20) par requête + 0,5 crédit ($0,0025) par réponse
AI Search Visibility APILe total des réponses IA qui mentionnent un domaine ou un mot-clé, puis des ventilations par domaines cités, domaines des résultats web et (sur ChatGPT) marques et catégories de marques40 crédits ($0,20) par requête + 0,5 crédit ($0,0025) par ligne
LLM Top Sources APILes dix domaines ou pages les plus cités par les réponses IA pour un mot-clé ou un domaine, classés par mentions40 crédits ($0,20) par requête + 0,5 crédit ($0,0025) par domaine ou page classé
Google AI Mode APILa réponse complète de Google AI Mode pour une recherche, en Markdown, avec toutes les sources citées2 crédits ($0,01) par requête

Pour les trois endpoints LLM, la base de 40 crédits s’applique aussi lorsque rien n’est trouvé.

Authentification et flux de tâches asynchrones

Toutes les requêtes SocQ s’authentifient avec une clé API dans l’en-tête Authorization, et le même en-tête sert pour l’envoi, le statut de la tâche et la récupération des résultats :

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Chaque collecte s’exécute comme une tâche en arrière-plan :

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

La réponse à l’envoi contient data.task_id et data.status. Interrogez l’endpoint des tâches avec cet ID :

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Lorsque status vaut succeeded, la réponse inclut la première page d’enregistrements normalisés dans data.results.items. limit vaut 50 par défaut et peut aller jusqu’à 500. Si has_more vaut true, passez results.next_cursor comme cursor pour lire la page suivante. Tant qu’une tâche est queued, running ou failed, l’endpoint renvoie les métadonnées de la tâche sans results.

Un callback_url facultatif dans le corps de l’envoi fait que SocQ envoie un POST unique avec un résumé de la tâche quand elle se termine ; lisez ensuite les enregistrements avec GET /v1/tasks/{task_id}. Un délai d’expiration côté client n’annule pas la tâche : reprenez avec le même ID de tâche au lieu de payer un doublon. 402 signifie crédits insuffisants ; 429 signifie que la clé a atteint une limite de débit ou de crédits.

LLM Mentions API : les réponses qui vous citent

La LLM Mentions API liste les questions pour lesquelles Google AI Overviews ou ChatGPT citent votre domaine, ou dans lesquelles votre marque ou votre mot-clé apparaît dans la réponse. Indiquez un domaine dans target ou un mot-clé dans query, pas les deux. platform vaut google (AI Overviews, valeur par défaut) ou chat_gpt, suivi pour les États-Unis en anglais. results_limit vaut 100 par défaut et accepte de 1 à 1 000.

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
  }'

Chaque ligne correspond à une question et une réponse. Les champs les plus utiles :

  • question et answer : la question et la réponse complète en Markdown.
  • ai_search_volume : nombre estimé de fois par mois où la question est posée.
  • sources : pages citées avec position, title, url, domain, source et text.
  • search_results et brands : les résultats web consultés par l’IA et les marques qu’elle a citées (ChatGPT uniquement).
  • fan_out_queries : les recherches complémentaires lancées par l’IA.
  • first_seen_at et last_seen_at : quand la réponse a été enregistrée pour la première et la dernière fois.

Utilisez-la pour auditer votre couverture GEO, repérer les pages auxquelles l’IA fait confiance dans votre niche ou détecter les réponses qui décrivent mal votre produit. 100 réponses coûtent 90 crédits ($0,45). Consultez la documentation LLM Mentions pour tous les champs.

AI Search Visibility API : la part de voix dans les réponses IA

L’AI Search Visibility API est un rapport de part de voix. La première ligne donne le nombre total de réponses IA qui mentionnent votre domaine ou votre mot-clé et le volume mensuel de recherche IA correspondant. Viennent ensuite jusqu’à 10 lignes pour chaque ventilation : les domaines les plus cités par les réponses, les domaines des résultats web consultés par l’IA et, sur chat_gpt, les marques et catégories de marques citées dans les mêmes réponses.

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"
  }'

Chaque ligne comporte une dimension (total, source_domain, search_result_domain, brand ou brand_category), un name, un rank au sein de sa dimension, mentions_count et ai_search_volume. Lancez-la pour votre marque et deux concurrents afin de comparer qui l’IA recommande. Un rapport ChatGPT avec le total et quatre ventilations complètes compte 41 lignes, soit 60,5 crédits ($0,3025). Référence des champs : documentation AI Search Visibility.

LLM Top Sources API : les sites que l’IA cite sur un sujet

La LLM Top Sources API répond à une autre question : quels sites l’IA cite-t-elle quand on l’interroge sur votre catégorie ? Indiquez un mot-clé dans query ou un domaine dans target. Réglez content_type sur domains (valeur par défaut) ou pages. results_limit vaut 10 par défaut, ce qui est aussi le maximum.

curl -X POST "https://api.socq.ai/v1/ai-search/llm-top-mentioned" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "crm software",
    "platform": "google",
    "content_type": "domains"
  }'

Les lignes utilisent la même structure de métriques qu’AI Search Visibility, avec dimension égal à domain ou page. La vue par pages fournit une liste prête à l’emploi pour vos actions de relations presse digitales. Dix lignes classées coûtent 45 crédits ($0,225). Détails : documentation LLM Top Sources.

Google AI Mode API : une réponse complète avec ses sources

AI Mode est l’onglet conversationnel de la recherche Google qui rédige une réponse complète au lieu de lister des liens. La Google AI Mode API prend une query et renvoie cette réponse en Markdown, avec une liste dédoublonnée des sources citées. Les valeurs par défaut sont les États-Unis (location_code 2840) et l’anglais (language_code en) ; modifiez-les pour comparer les réponses selon les pays et les langues.

curl -X POST "https://api.socq.ai/v1/ai-search/google-ai-mode" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "best crm for startups",
    "location_code": 2840,
    "language_code": "en"
  }'

Chaque requête renvoie une ligne avec query, answer, references (position, titre, URL, domaine, source et extrait), location_code, language_code et l’url de la page AI Mode. À 2 crédits ($0,01) par recherche, c’est un moyen économique de vérifier si vos pages figurent parmi les sources des recherches qui vous importent. Consultez la documentation Google AI Mode.

Quel endpoint utiliser

  • « Quelles réponses IA nous mentionnent, et que disent-elles ? » Utilisez LLM Mentions.
  • « Quelle est notre visibilité dans les réponses IA par rapport à nos concurrents ? » Utilisez AI Search Visibility, une fois par domaine.
  • « Quels sites démarcher pour que l’IA nous cite ? » Utilisez LLM Top Sources avec content_type: "pages".
  • « Que dit Google AI Mode pour cette recherche précise, sur ce marché ? » Utilisez Google AI Mode.

Un ordre courant consiste à lancer LLM Top Sources pour la catégorie, AI Search Visibility pour vous et vos concurrents, puis LLM Mentions pour lire les réponses derrière les chiffres. Pour les classements classiques, consultez la plateforme SEO.

FAQ

Qu’est-ce qu’une API de recherche IA ?

Une API qui renvoie ce que disent les moteurs de réponse IA au lieu d’une liste de liens. La version de SocQ couvre les réponses AI Overviews et ChatGPT qui mentionnent un domaine ou un mot-clé, les métriques de visibilité, les sources les plus citées et les réponses complètes de Google AI Mode.

Quelles plateformes IA sont couvertes ?

Les trois endpoints LLM acceptent platform réglé sur google (AI Overviews, valeur par défaut) ou chat_gpt. ChatGPT est suivi pour les États-Unis en anglais. Les lignes de marques et de catégories de marques, les résultats web de l’IA et les listes de marques n’apparaissent que pour chat_gpt.

Puis-je envoyer un domaine et un mot-clé dans la même requête ?

Non. LLM Mentions, AI Search Visibility et LLM Top Sources acceptent soit target (un domaine), soit query (un mot-clé), pas les deux. Lancez deux requêtes si vous avez besoin des deux vues.

Suis-je facturé lorsqu’aucune réponse IA n’est trouvée ?

Oui : pour les trois endpoints LLM, la base de 40 crédits s’applique lorsque rien n’est trouvé ; les crédits par résultat ne s’appliquent qu’aux lignes renvoyées. Google AI Mode coûte 2 crédits par requête.

Combien coûte un audit GEO type ?

Une requête LLM Top Sources (45 crédits), trois rapports de visibilité ChatGPT (jusqu’à 60,5 crédits chacun) et une requête LLM Mentions de 100 réponses (90 crédits) représentent au maximum 316,5 crédits, soit environ $1,58. Les tarifs peuvent changer : vérifiez d’abord les pages des endpoints.

AI SEARCH API

Tester le workflow avec une URL publique AI Search

Envoyez des entrées publiques et recevez des enregistrements normalisés, avec un contexte de source traçable.

Découvrir les API AI Search