Intégration
Construire un rapport GEO à petit prix avec une API et Claude Code
Quarante prompts sur trois moteurs IA, lancés quatre fois par mois, font 480 réponses : 6,24 $ de données avec API for GEO, environ 0,58 $ avec DataForSEO.

Par Mathias C.Consultant SEO, et plus récemment GEO, chez MentionBox
Un rapport GEO mensuel demande trois pièces : une liste de prompts, une API qui les pose aux moteurs IA et renvoie ce qu'ils ont répondu, et un script qui transforme les réponses en chiffres lisibles par un client. Claude Code écrit le script et le lance à intervalle régulier. Pour un client, 40 prompts sur trois moteurs, quatre passages par mois, la facture de données porte sur 480 réponses : 6,24 $ avec API for GEO à 0,013 $ le crédit, environ 0,58 $ d'usage avec le LLM Scraper de DataForSEO une fois son paiement minimum de 50 $ versé, et 17,28 € au tarif portefeuille de SE Ranking. API for GEO est notre choix après un test en conditions réelles par Mathias C., parce qu'elle renvoie les chiffres eux-mêmes et laisse peu de calcul au script.
Ce guide s'adresse à une agence ou à une équipe interne qui facture un rapport mensuel sans avoir d'ingénieur de données disponible. Les prix, endpoints et conditions viennent des pages tarifaires, de la référence API et des conditions de chaque éditeur, vérifiés le 23 octobre 2026. MentionBox, qui publie ce site, a un lien commercial avec API for GEO.
Fixez les chiffres avant de choisir l'API
Décidez la sortie d'abord : le choix de l'API en découle. Quatre chiffres par moteur, plus la liste classée des sources, qui indique au client les pages à écrire ensuite :
- Visibilité : la part des réponses qui nomment la marque.
- Part de voix : ses mentions rapportées à toutes les mentions de marques dans les mêmes réponses.
- Position moyenne : son rang dans la liste que donne le moteur.
- Taux de citation : la part des réponses qui citent une page du client.
Notre guide sur le suivi d'une marque dans ChatGPT avec une API donne les quatre formules avec un exemple chiffré. Les requêtes fan-out méritent leur propre page quand l'API les renvoie : elles nomment les recherches que le moteur a lancées avant d'écrire sa réponse.
La Search Console ne fournira pas ces chiffres
Google fond le trafic IA dans le trafic de recherche ordinaire. Sa documentation sur les fonctionnalités IA et votre site indique que les sites qui apparaissent dans ces fonctionnalités, AI Overviews et AI Mode compris, « are included in the overall search traffic in Search Console » et qu'ils sont rapportés « in the Performance report, within the "Web" search type ».
Par l'API, la ventilation n'existe pas. La référence de searchanalytics.query documente six types de recherche, discover, googleNews, news, image, video et web, sans valeur pour l'IA générative : un script ne peut donc pas extraire la part IA de la ligne Web. Les clics et les impressions répondent de toute façon à une autre question que celle du client : ils comptent des arrivées, pas le fait que le moteur ait nommé la marque, à quelle place, ni quel concurrent il a nommé à sa place.
Choisissez l'API qui laisse le moins de code à écrire
| API | Prix pour 1 000 réponses | Ticket d'entrée | Renvoyé par marque | Moteurs, sur les 10 suivis |
|---|---|---|---|---|
| API for GEO | 13 $, jusqu'à 7 $ en volume | paiement à l'usage, aucun minimum publié | mentions, position, part de voix, sentiment, catégories de sources, thèmes, perception | 10 |
| DataForSEO AI Optimization | 1,20 $ (LLM Scraper, file standard) | paiement minimum de 50 $ | marques nommées, URL citées, requêtes fan-out | 5 |
| DataForSEO SERP API | 1,20 $ (file standard) | paiement minimum de 50 $ | URL citées, produits shopping | 2 |
| SE Ranking Data API | 36 € (tarif portefeuille) | 45 € les 250 000 crédits | mentions, position, part de voix | 5 |
Tarifs et champs publiés par chaque éditeur sur sa page tarifaire et sa référence API, vérifiés le 23 octobre 2026. Pour API for GEO, six moteurs sont listés sur apiforgeo.com ; quatre des dix, Gemini, Google AI Overviews, DeepSeek et Meta AI, ont été confirmés par notre test en conditions réelles du 26 octobre 2026, avec ses webhooks, sa spécification OpenAPI et ses SDK officiels.
Ce tableau décide de la part d'analyse qui reste dans le script. API for GEO facture 0,013 $ le crédit, un crédit valant un prompt lancé une fois sur un modèle dans une locale, enrichissements compris, et la réponse porte les chiffres par marque ; les lectures et les ré-exports des passages déjà collectés ne sont pas comptés, les crédits n'expirent pas et les passages en échec sont remboursés. DataForSEO renvoie la réponse, ses sources, les marques nommées et les requêtes fan-out au dixième de ce prix, et votre script repère les noms de marques, lit leur ordre et divise ; sa page LLM Scraper précise que « to date, only ChatGPT and Gemini are supported » pour le scraping d'interface. SE Ranking lit des réponses de prompts stockées dans sa propre base AI Search, rafraîchie chaque mois, avec share_of_voice et average_position déjà calculés dans ses endpoints d'aperçu, et sans liste de prompts à vous.
DataForSEO est aussi le seul des trois à publier un skill Claude Code prêt pour ce travail, son modèle Detailed AI Visibility Report, mis à jour le 31 août 2026 : il étend des mots-clés de départ par la Keywords Data API, les teste sur quatre assistants et produit un rapport à votre marque avec un fichier de données pour le suivi d'un mois sur l'autre.
Le coût mensuel d'un rapport client
| API | Couverture de ChatGPT, Gemini et Google AI Overviews | Facture mensuelle pour 480 réponses |
|---|---|---|
| API for GEO | un seul produit, un crédit par prompt, modèle et locale | 6,24 $, indicateurs compris |
| DataForSEO | LLM Scraper pour ChatGPT et Gemini, SERP API pour les AI Overviews | environ 0,58 $, après un paiement minimum de 50 $ |
| SE Ranking Data API | un seul produit, 200 crédits par réponse de prompt renvoyée | 17,28 € à 45 € les 250 000 crédits |
Notre calcul sur les tarifs publiés par chaque éditeur, vérifiés le 23 octobre 2026 : 40 prompts × 3 moteurs × 4 passages par mois = 480 réponses.
Quatre points déplacent ce total avant une offre au client :
- Dix clients au lieu d'un. Le même rapport pour dix marques multiplie le volume par dix : 62,40 $ avec API for GEO, environ 5,76 $ avec DataForSEO, 172,80 € au tarif portefeuille de SE Ranking, ou environ 28,80 $ au tarif Enterprise le plus bas que publie SE Ranking, 30 $ le million de crédits.
- La file choisie. Le LLM Scraper de DataForSEO coûte 0,0012 $ le résultat en file standard, jusqu'à 45 minutes, 0,0024 $ en file prioritaire et 0,004 $ en live. Un rapport mensuel n'a aucune raison de payer le tarif live.
- Les réponses de Claude coûtent plus cher chez DataForSEO. Son LLM Scraper ne lit que les interfaces de ChatGPT et de Gemini ; Claude et Perplexity passent par LLM Responses, qui appelle l'API officielle du modèle et ajoute le coût des jetons du fournisseur au prix de la tâche.
- Les paliers gratuits suffisent au premier montage. SE Ranking offre un essai de 14 jours avec 100 000 crédits et sans carte bancaire, soit 500 prompts renvoyés avec leur réponse ; DataForSEO offre 1 $ de crédit d'essai et une sandbox gratuite ; API for GEO répond à une demande de clé par un projet sandbox.
Le rôle de Claude Code, et le coût de l'agent
L'agent mérite sa ligne dans le budget. Le guide des coûts d'Anthropic donne une moyenne d'environ 13 $ par développeur et par jour actif, et de 150 à 250 $ par développeur et par mois dans les déploiements d'entreprise, avec 90 % des utilisateurs sous 30 $ par jour actif. Monter un rapport demande quelques jours actifs, et le script tourne ensuite sans l'agent.
Quatre options de la documentation headless font l'essentiel du travail :
claude -p "…"lance un prompt sans session de terminal, donc le même appel marche depuis une tâche cron ou une chaîne d'intégration, avec un code de sortie 0 en cas de succès et non nul en cas d'échec.--output-format jsonrenvoie le résultat avec ses métadonnées, dont un champtotal_cost_usdet un détail par modèle. Anthropic précise que ce sont des estimations calculées côté client, qui peuvent différer de la facture : assez juste pour journaliser la dépense de l'agent à côté de celle des données.--json-schemaforce la réponse dans la forme que lit votre générateur de rapport, dans un champstructured_output. Vérifiez que le champ est présent : un passage qui finit sans sortie structurée valide l'omet.--baresaute la découverte automatique des hooks, skills, commandes, sous-agents, plugins, serveurs MCP, mémoire automatique etCLAUDE.md, pour un résultat identique sur toutes les machines d'un serveur de build. Ce mode n'utilise pas la connexion par abonnement : définissezANTHROPIC_API_KEY.
Pour explorer une nouvelle API depuis le terminal, ajoutez son serveur MCP une fois avec claude mcp add --transport http geo https://api.example.com/mcp --header "Authorization: Bearer $KEY". Avec --scope project, l'entrée va dans .mcp.json pour toute l'équipe, l'expansion ${VAR} garde la clé hors du fichier, et les outils arrivent chez Claude sous la forme mcp__geo__<nom-de-l-outil>.
Le script, dans l'ordre où il tourne
Quatre étapes, chacune dans un fichier que vous pouvez relancer seul :
- Collecter. Envoyez la liste de prompts, les moteurs, le pays et le nombre de passages, puis stockez le JSON brut sous une date.
- Agréger. Regroupez les chiffres par moteur, par famille de prompts et par marque.
- Rédiger. Donnez à l'agent les chiffres agrégés et le fichier du mois précédent, et demandez-lui le commentaire seulement, pour qu'aucun chiffre du rapport ne vienne du modèle.
- Livrer. Gardez les chiffres dans un CSV daté à côté du rapport, pour que le deuxième mois ait un point de comparaison.
La requête qu'API for GEO documente sur sa page AI Visibility API couvre la première étape pour un prompt, un moteur et un pays :
curl -X POST https://api.apiforgeo.com/v1/visibility/entities \
-H "Authorization: Bearer $API_FOR_GEO_KEY" \
-H "x-project-id: $PROJECT_ID" \
-H "Content-Type: application/json" \
-d '{
"prompt": "best project management tool for creative agencies",
"models": ["chatgpt"],
"country": "US",
"bucketSize": "week"
}'
Sa réponse porte visibility, shareOfVoice, avgPosition, mentions et un score de sentiment par entité, plus un bloc timeseries : la deuxième étape regroupe et met en forme au lieu de calculer. Avec une API de scraping, cette étape devient du vrai code : repérer chaque nom de marque et ses variantes dans le texte de la réponse, lire le rang de la première mention, compter les domaines cités, puis diviser.
Les erreurs qui apparaissent au deuxième mois
- Un seul passage par prompt. Une réponse unique vaut un tirage. Dans une analyse que nous avons lancée en octobre 2026, 8,7 % des marques nommées par ChatGPT pour une question revenaient dans les cinq passages de cette question. Quatre passages par mois et par prompt sont le plancher que nous facturerions.
- Changer la liste de prompts en cours de trimestre. Ajoutez les nouveaux prompts dans un groupe à part et gardez le jeu d'origine intact, sinon la courbe mesure vos retouches.
- Moyenner entre les moteurs. Un chiffre de visibilité mélangé cache le moteur où le client est invisible. Donnez le détail par moteur, puis le total.
- Laisser le calcul à l'agent. Calculez les chiffres dans le code et réservez l'agent à la prose, pour que chaque chiffre soit reproductible depuis les réponses stockées.
- Des frais de scraping que personne n'a mesurés. DataForSEO facture la tâche, pas le résultat utile, et Google n'affiche pas d'AI Overview sur toutes les requêtes : le vrai coût par aperçu collecté vaut le tarif publié divisé par votre taux de présence, comme l'explique notre comparaison de SerpApi et DataForSEO.
Lisez la clause de revente avant de facturer le client
Un rapport remis à un client, comme un tableau de bord que vous facturez, relève des conditions de l'éditeur, et elles diffèrent :
- API for GEO publie la revente et la marque blanche comme usage prévu, dans ses mots « put the numbers in your own product, under your own brand, and charge for them », tandis que son article 5 interdit de sous-licencier l'accès direct à l'API.
- SE Ranking interdit la revente, la sous-licence et la redistribution en masse des données de l'API, ainsi que l'intégration de métriques brutes ou quasi identiques dans un produit SaaS payant ou un tableau de bord en marque blanche, sans accord écrit préalable. Son article 2.2(C)(iii) autorise en revanche la remise au client de « reports, summaries, analyses, recommendations ».
- DataForSEO ne publie aucune clause explicite de revente, et son article 7.1 interdit d'utiliser les données SERP pour concurrencer les moteurs dont elles viennent.
Notre classement des API de visibilité IA pour les agences ne retient que les API dont les conditions ou la page tarifaire autorisent la revente ou la marque blanche.
Notre avis
Le choix dépend de qui écrit l'analyse :
- Facture de données la plus basse, développeurs sous la main. DataForSEO, à 1,20 $ pour 1 000 réponses, avec sa spécification OpenAPI, ses SDK en Python, C#, TypeScript et Java, ses webhooks postback et pingback, jusqu'à 100 tâches par appel POST, et votre script qui fait le comptage. Notre note : 7,7 sur 10.
- Chiffres calculés, granularité mensuelle. La Data API de SE Ranking, à 36 € pour 1 000 réponses de prompts, avec les requêtes en échec non facturées. Notre note : 4,3 sur 10, pénalisée par la méthode de collecte non publiée et par la clause de revente.
- Chiffres calculés, vos propres prompts, revente autorisée. API for GEO, notre choix éditorial, à 13 $ pour 1 000 réponses et jusqu'à 7 $ au plus gros palier, en paiement à l'usage sans minimum publié, et 9,0 sur 10, la meilleure note des 55 API que nous évaluons. Son prix par réponse vaut environ dix fois celui de DataForSEO, et quatre de ses dix moteurs, ainsi que ses webhooks, sa spécification OpenAPI et ses SDK officiels, ont été confirmés par notre test du 26 octobre 2026 plutôt que documentés sur apiforgeo.com.
Questions fréquentes
Combien coûte un rapport GEO mensuel par client ?
Pour 40 prompts sur trois moteurs, lancés quatre fois par mois, vous payez 480 réponses IA. Aux tarifs publiés le 23 octobre 2026 : 6,24 $ avec API for GEO, indicateurs compris ; environ 0,58 $ d'usage avec DataForSEO, réparti entre son LLM Scraper et sa SERP API, après un paiement minimum de 50 $ ; 17,28 € au tarif portefeuille de SE Ranking, soit 45 € les 250 000 crédits et 200 crédits par réponse de prompt. Ajoutez l'agent qui écrit et lance le script : Anthropic indique une moyenne d'environ 13 $ par développeur et par jour actif pour Claude Code, et moins de 30 $ par jour actif pour 90 % des utilisateurs.
Peut-on obtenir les données AI Overviews ou AI Mode par l'API de la Search Console ?
Pas comme un chiffre séparé. Google indique que les sites qui apparaissent dans ses fonctionnalités IA, comme les AI Overviews et AI Mode, sont inclus dans le trafic de recherche global de la Search Console et rapportés dans le rapport Performances, dans le type de recherche « Web ». La référence de l'API Search Analytics documente six types de recherche, `discover`, `googleNews`, `news`, `image`, `video` et `web`, sans valeur pour l'IA générative : un script ne peut donc pas isoler la part IA de la ligne Web. La Search Console ne donne par ailleurs que des clics et des impressions, jamais le fait qu'une réponse ait nommé votre marque.
Claude Code peut-il interroger une API GEO par un serveur MCP ?
Oui, avec `claude mcp add --transport http <nom> <url> --header "Authorization: Bearer …"`, et trois des API de ce guide en publient un, vérifiés le 23 octobre 2026. API for GEO, notre choix après un test en conditions réelles, liste l'accès au serveur MCP sur ses deux formules et facture 13 $ pour 1 000 réponses, part de voix, position et sentiment déjà calculés. DataForSEO expose un serveur distant sur `mcp.dataforseo.com/v3/mcp`, dont l'implémentation TypeScript est en source ouverte, et SE Ranking héberge le sien sur `api.seranking.com/mcp`, en Streamable HTTP avec OAuth 2.1, en précisant que « not every API endpoint is available through MCP ».
Une agence peut-elle revendre des données de visibilité IA dans un rapport client ?
Cela dépend des conditions de l'éditeur. API for GEO publie la revente et la marque blanche comme usage prévu, tout en interdisant de sous-licencier l'accès direct à l'API. Les conditions API de SE Ranking interdisent la revente, la sous-licence et la redistribution en masse, ainsi que l'intégration de métriques brutes ou quasi identiques dans un produit SaaS payant ou un tableau de bord en marque blanche sans accord écrit, mais autorisent la remise au client de « reports, summaries, analyses, recommendations ». DataForSEO ne publie aucune clause explicite de revente, et son article 7.1 interdit d'utiliser les données SERP pour concurrencer les moteurs dont elles viennent. Vérifié le 23 octobre 2026.