API REST
L'API de visibilité IA et de suivi de classement pour votre stack de reporting
Récupérez les données de visibilité, de prompts, de réponses, de citations et de concurrents de Geoptie dans BigQuery, Looker Studio, des tableaux de bord clients ou votre propre produit. Une seule clé bearer, du JSON en HTTPS, et aucun quota mensuel de requêtes.
ChatGPT
Claude
Perplexity
Gemini
AI Overviews- AI Mode
Copilot
curl -sS "https://api.geoptie.com/v1/brands" \
-H "Authorization: Bearer $GEOPTIE_API_KEY"{
"data": [
{
"id": "3f2a6c1e-0b7d-4e59-9a41-2c8d5e7f9b10",
"name": "Example Brand",
"domain": "example.com",
"engines": ["chatgpt", "claude", "perplexity", "gemini"],
"country": "US"
}
],
"has_more": false,
"next_cursor": null
}v1
API REST stable
7
moteurs IA couverts
120/min
requêtes, sans plafond mensuel
$99
par mois, offre Professionnel
Adopté par des équipes marketing et des agences
Qu'est-ce qu'une API de visibilité IA ?
Une API de visibilité IA indique comment des moteurs IA comme ChatGPT, Claude, Perplexity, Gemini et les réponses IA de Google mentionnent et citent une marque, sous forme de données exploitables par vos propres systèmes. Elle sert aussi d'API de suivi de classement IA : visibilité et position pour chaque prompt suivi, sur chaque moteur, chaque jour.
L'API REST de Geoptie fournit les mêmes métriques que le tableau de bord : les chiffres d'un data warehouse, d'un tableau de bord BI, d'un rapport client ou d'une alerte Slack correspondent à ce que voit votre équipe.
Votre première requête en moins d'une minute
Créez une clé dans le tableau de bord et envoyez-la comme jeton bearer. GET /v1/brands confirme que la clé fonctionne et renvoie les identifiants de marque utilisés par tous les autres endpoints.
Configuration en trois étapes
- 1
Créer une clé
Dans le tableau de bord, sous Clés API, pour tout l'espace de travail ou pour certaines marques.
- 2
Appeler GET /v1/brands
Cet appel confirme que la clé fonctionne et renvoie les identifiants de marque utilisés par tous les autres endpoints.
- 3
Récupérer les données utiles
Visibilité, prompts, réponses, citations et concurrents, par marque et par moteur.
curl -sS "https://api.geoptie.com/v1/brands" \
-H "Authorization: Bearer $GEOPTIE_API_KEY"import os, requests
r = requests.get(
"https://api.geoptie.com/v1/brands",
headers={"Authorization": f"Bearer {os.environ['GEOPTIE_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json())const r = await fetch("https://api.geoptie.com/v1/brands", {
headers: { Authorization: `Bearer ${process.env.GEOPTIE_API_KEY}` },
});
if (!r.ok) throw new Error(`${r.status} ${await r.text()}`);
console.log(await r.json());Catalogue des endpoints
Marques
- GET
/v1/ brands - POST
/v1/ brands - GET
/v1/ brands/ {id} - GET
/v1/ brands/ {id}/ visibility
Prompts et réponses
- GET
/v1/ brands/ {id}/ prompts - POST
/v1/ brands/ {id}/ prompts - GET
/v1/ prompts/ {id}/ responses - GET
/v1/ prompts/ {id}/ mentions
Citations
- GET
/v1/ brands/ {id}/ citations - GET
/v1/ brands/ {id}/ citations/ urls - GET
/v1/ brands/ {id}/ citations/ domains - GET
/v1/ brands/ {id}/ citations/ trends
Concurrents
- GET
/v1/ brands/ {id}/ competitors - GET
/v1/ brands/ {id}/ competitors/ trends - POST
/v1/ brands/ {id}/ tracked-competitors - POST
/v1/ brands/ {id}/ ignored-competitors
Recommandations et audits
- GET
/v1/ brands/ {id}/ recommendations - POST
/v1/ brands/ {id}/ recommendations/ generate - POST
/v1/ audit-reports - GET
/v1/ audit-reports/ {id}
Contenu
- POST
/v1/ brands/ {id}/ generations - POST
/v1/ brands/ {id}/ generations/ {generationId}/ draft - POST
/v1/ brands/ {id}/ optimizations - GET
/v1/ brands/ {id}/ topics
48 opérations au total, mises à jour et suppressions comprises. La référence complète se trouve dans la documentation API.
Conçue pour le reporting en production
L'API renvoie les chiffres de votre tableau de bord, dans un format qui s'intègre directement à un data warehouse ou à un rapport client.
Les mêmes chiffres que le tableau de bord
Visibilité, position et part de voix précalculées, pas des lignes brutes à réassembler : un rapport client correspond à ce que voit votre équipe.
Lecture et écriture
Suivez des prompts, gérez thèmes et concurrents, traitez la file de recommandations, lancez des audits et générez du contenu via la même API.
Clés par espace de travail ou par marque
Donnez à un client, un tableau de bord ou une équipe interne une clé qui n'accède qu'à sa propre marque. Une révocation prend effet en moins d'une minute.
Des tâches cadencées et prévisibles
Pagination par curseur, dates ISO 8601 et en-têtes de rate limit sur chaque réponse, pour qu'une tâche planifiée régule son rythme sans tomber sur une erreur 429.
Des erreurs exploitables
Des codes de statut HTTP standard avec un code d'erreur stable, et un X-Request-Id sur chaque réponse pour le suivi par le support.
Un versionnage stable
La v1 est stable. Les nouveaux champs sont ajoutés sans préavis, et les changements incompatibles arrivent en /v2 avec 90 jours de préavis.
Ce que les équipes en font
Tableaux de bord clients
Les agences alimentent Looker Studio ou leur propre portail avec la visibilité IA de chaque client, grâce à une clé limitée par marque pour chaque client.
Synchronisation vers l'entrepôt de données
Une tâche nocturne copie les données de visibilité, de citations et de concurrents dans BigQuery ou Snowflake, à côté des données SEO et analytics.
Alertes
Une vérification planifiée publie dans Slack ou envoie un e-mail quand un prompt prioritaire recule sur un moteur.
Assistants IA
La même clé alimente le serveur MCP de Geoptie pour Claude Code, Cursor et Codex.
Inclus dans Professionnel et Entreprise
FAQ de l'API de visibilité IA
Quelles données l'API Geoptie renvoie-t-elle ?
Quelles offres incluent l'accès API ?
Comment fonctionne l'authentification ?
Quelles sont les limites de débit de l'API ?
Puis-je récupérer les données concurrentielles via l'API ?
Puis-je donner à un client un accès API limité à sa propre marque ?
Quels moteurs IA l'API couvre-t-elle ?
Existe-t-il aussi un serveur MCP ?
Placez la visibilité IA à côté du reste de vos données
Démarrez avec Professionnel, créez une clé, et votre première requête renvoie vos marques en moins d'une minute.
Commencer