API v1.1 · MCP
API and MCP
Get your AI visibility scores where you work: in Looker Studio, Sheets or n8n with the API, or right inside Claude and ChatGPT with the MCP connector.
REST API
Create an API key in Geoperf → API & MCP. Starter plan and above. 60 requests per minute.
MCP connector
Add https://geoperf.com/mcp in Claude or ChatGPT and connect your account. Every plan, read access.
Authentication
Authorization: Bearer gp_live_xxxxxxxxxxxxxxxxxxxxxxxx
Send your key in the Authorization header. It is shown only once, when created: keep it in a secrets manager. An OAuth access token obtained through the MCP connector is accepted too.
Base URL
https://geoperf.com/api/v1
OpenAPI 3.1 specification: https://geoperf.com/api/v1/openapi.json
Limits
60 requests per minute per key (429 with Retry-After beyond). Starting a report uses AI credits: one report every 7 days on Starter, one per brand per 24 hours on Growth, Pro and Agency for reports started through the API or MCP.
Quickstart
# Your brands and their latest score curl -H "Authorization: Bearer gp_live_xxx" https://geoperf.com/api/v1/brands # ChatGPT score over the last 8 reports curl -H "Authorization: Bearer gp_live_xxx" "https://geoperf.com/api/v1/brands/<brand-id>/scores?llm=chatgpt&limit=8" # Who is cited ahead of you on Perplexity curl -H "Authorization: Bearer gp_live_xxx" "https://geoperf.com/api/v1/brands/<brand-id>/competitors?llm=perplexity" # Start a report (key with write permission) curl -X POST -H "Authorization: Bearer gp_live_xxx" https://geoperf.com/api/v1/brands/<brand-id>/snapshots
In n8n or Make: HTTP Request node, GET, header Authorization: Bearer <your key>. Lists return next_cursor: pass it as ?cursor= to get the next page.
Endpoints
| GET | /me | Plan, role, key permissions, limits and last-minute usage. |
| GET | /brands | Your brands, with the summary of their latest report. |
| GET | /brands/{id} | One brand and its latest report. |
| GET | /brands/{id}/scores | Scores report after report, overall and per AI assistant (?llm=chatgpt). |
| GET | /brands/{id}/competitors | Competitors cited by AI assistants: mentions, share of voice, rank, times they rank above you. |
| GET | /brands/{id}/sources | Websites the AI assistants cite as sources, ranked by share of answers. |
| GET | /brands/{id}/answers | AI answers, filterable by assistant, by word (?q=) and by brand mention (?mentioned=). |
| GET | /brands/{id}/snapshots | Report history (cursor pagination). |
| GET | /brands/{id}/snapshots/{sid} | One report with every answer. |
| POST | /brands/{id}/snapshots | Start a report (write permission). Starter: one every 7 days; Growth, Pro, Agency: one per brand per 24 h. |
| GET | /brands/{id}/recommendations | Recommendations, newest first. |
| GET | /brands/{id}/alerts | Brand alerts; /alerts for all your brands. |
Response format
{ "ok": true, "data": { … }, "next_cursor": "…", "request_id": "…" }
{ "ok": false, "error": "Brand not found.", "code": "brand_not_found", "request_id": "…" }HTTP codes: 200, 202 (report started), 400, 401 (invalid key or token), 403 (plan or permission), 404, 409 (report already running), 429 (limit).
MCP server
The same access, for AI assistants: 9 tools (brands, report, score history, competitors, sources, AI answers, recommendations, alerts, run a report). OAuth sign-in with your Geoperf account, or an API key for agents that send a header.
https://geoperf.com/mcp
Ready to plug in your data?
The MCP connector comes with every plan, the REST API from Starter (€79/month excl. VAT).