API v1.1 · MCP
API et MCP
Récupérez vos scores de visibilité dans les IA là où vous travaillez : dans Looker Studio, Sheets ou n8n avec l'API, ou directement dans Claude et ChatGPT avec le connecteur MCP.
API REST
Clé API à créer dans Geoperf → API et MCP. Plans Starter et plus. 60 requêtes par minute.
Connecteur MCP
Ajoutez https://geoperf.com/mcp dans Claude ou ChatGPT et connectez votre compte. Tous les plans, en lecture.
Authentification
Authorization: Bearer gp_live_xxxxxxxxxxxxxxxxxxxxxxxx
Envoyez votre clé dans l'en-tête Authorization. Elle n'est affichée qu'une fois, à sa création : rangez-la dans un gestionnaire de secrets. Un jeton OAuth obtenu par le connecteur MCP est aussi accepté.
Adresse de base
https://geoperf.com/api/v1
Spécification OpenAPI 3.1 : https://geoperf.com/api/v1/openapi.json
Limites
60 requêtes par minute et par clé (réponse 429 et en-tête Retry-After au-delà). Lancer un rapport coûte des crédits IA : 1 rapport tous les 7 jours en Starter, 1 par marque et par 24 h en Growth, Pro et Agency pour les rapports lancés par l'API ou le MCP.
Démarrage rapide
# Vos marques et leur dernier score curl -H "Authorization: Bearer gp_live_xxx" https://geoperf.com/api/v1/brands # Évolution du score dans ChatGPT sur les 8 derniers rapports curl -H "Authorization: Bearer gp_live_xxx" "https://geoperf.com/api/v1/brands/<brand-id>/scores?llm=chatgpt&limit=8" # Qui est cité avant vous sur Perplexity curl -H "Authorization: Bearer gp_live_xxx" "https://geoperf.com/api/v1/brands/<brand-id>/competitors?llm=perplexity" # Lancer un rapport (clé avec le droit write) curl -X POST -H "Authorization: Bearer gp_live_xxx" https://geoperf.com/api/v1/brands/<brand-id>/snapshots
Dans n8n ou Make : nœud HTTP Request, méthode GET, en-tête Authorization: Bearer <votre clé>. Les listes renvoient next_cursor : passez-le en ?cursor= pour la page suivante.
Endpoints
| GET | /me | Plan, rôle, droits de la clé, limites et usage de la dernière minute. |
| GET | /brands | Vos marques, avec le résumé de leur dernier rapport. |
| GET | /brands/{id} | Une marque et son dernier rapport. |
| GET | /brands/{id}/scores | Évolution des indicateurs rapport après rapport, au global et par IA (?llm=chatgpt). |
| GET | /brands/{id}/competitors | Concurrents cités par les IA : mentions, part de voix, rang, fois où ils passent devant vous. |
| GET | /brands/{id}/sources | Sites que les IA citent comme sources, classés par part des réponses. |
| GET | /brands/{id}/answers | Réponses des IA, filtrables par IA, par mot (?q=) et par mention de la marque (?mentioned=). |
| GET | /brands/{id}/snapshots | Historique des rapports (pagination par curseur). |
| GET | /brands/{id}/snapshots/{sid} | Détail d'un rapport avec chaque réponse. |
| POST | /brands/{id}/snapshots | Lancer un rapport (droit write). Starter : 1 tous les 7 jours ; Growth, Pro, Agency : 1 par marque et par 24 h. |
| GET | /brands/{id}/recommendations | Recommandations, les plus récentes d'abord. |
| GET | /brands/{id}/alerts | Alertes de la marque ; /alerts pour toutes vos marques. |
Format des réponses
{ "ok": true, "data": { … }, "next_cursor": "…", "request_id": "…" }
{ "ok": false, "error": "Brand not found.", "code": "brand_not_found", "request_id": "…" }Codes HTTP : 200, 202 (rapport lancé), 400, 401 (clé ou jeton invalide), 403 (plan ou droit insuffisant), 404, 409 (rapport déjà en cours), 429 (quota).
Serveur MCP
Le même accès, pour les assistants IA : 9 outils (marques, rapport, évolution des scores, concurrents, sources, réponses des IA, recommandations, alertes, lancer un rapport). Connexion OAuth avec votre compte Geoperf, ou clé API pour les agents qui envoient un en-tête.
https://geoperf.com/mcp
Prêt à brancher vos données ?
Le connecteur MCP est inclus dans tous les plans, l'API REST à partir de Starter (79 € HT/mois).