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/mePlan, rôle, droits de la clé, limites et usage de la dernière minute.
GET/brandsVos 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}/competitorsConcurrents cités par les IA : mentions, part de voix, rang, fois où ils passent devant vous.
GET/brands/{id}/sourcesSites que les IA citent comme sources, classés par part des réponses.
GET/brands/{id}/answersRéponses des IA, filtrables par IA, par mot (?q=) et par mention de la marque (?mentioned=).
GET/brands/{id}/snapshotsHistorique des rapports (pagination par curseur).
GET/brands/{id}/snapshots/{sid}Détail d'un rapport avec chaque réponse.
POST/brands/{id}/snapshotsLancer un rapport (droit write). Starter : 1 tous les 7 jours ; Growth, Pro, Agency : 1 par marque et par 24 h.
GET/brands/{id}/recommendationsRecommandations, les plus récentes d'abord.
GET/brands/{id}/alertsAlertes 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).