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/mePlan, role, key permissions, limits and last-minute usage.
GET/brandsYour brands, with the summary of their latest report.
GET/brands/{id}One brand and its latest report.
GET/brands/{id}/scoresScores report after report, overall and per AI assistant (?llm=chatgpt).
GET/brands/{id}/competitorsCompetitors cited by AI assistants: mentions, share of voice, rank, times they rank above you.
GET/brands/{id}/sourcesWebsites the AI assistants cite as sources, ranked by share of answers.
GET/brands/{id}/answersAI answers, filterable by assistant, by word (?q=) and by brand mention (?mentioned=).
GET/brands/{id}/snapshotsReport history (cursor pagination).
GET/brands/{id}/snapshots/{sid}One report with every answer.
POST/brands/{id}/snapshotsStart a report (write permission). Starter: one every 7 days; Growth, Pro, Agency: one per brand per 24 h.
GET/brands/{id}/recommendationsRecommendations, newest first.
GET/brands/{id}/alertsBrand 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).