Docs · GEO API

The AI citation API

Getspotted is the AI citation API for GEO (generative engine optimization): it returns the sources ChatGPT, Claude, Perplexity, Gemini and Google cite for any query, per country, scored with per-engine positions, plus the contacts behind them. Authenticate, send a query, get cited sources back. Every search covers all six engines and costs 10 credits.

1. Get an API key

Create a key in your dashboard under Developers → API keys. The secret is shown once, so store it safely. Send it on every request as Authorization: Bearer gsp_live_….

2. Make your first call

bash
curl -X POST https://getspotted.ai/api/v1/search \
  -H "authorization: Bearer gsp_live_…" \
  -H "content-type: application/json" \
  -d '{"query":"best CRM for B2B SaaS","country":"US"}'

You get back a list of cited sources, each with the engines that cited it, its per-engine position, and a cross-engine score. The strongest cross-engine sources are also surfaced as hotspots.

3. Pick your language

cURLQuickstartJavaScriptQuickstartNext.jsQuickstartPythonQuickstartGoQuickstartRubyQuickstartPHPQuickstartJavaQuickstartRustQuickstart

Use it from an AI agent

Connect the remote MCP server in one step and your agent (Claude Code, Cursor, Codex…) can call find_ai_sources and get_source_contacts directly.

MCP endpoint:  https://getspotted.ai/api/mcp
Auth header:   Authorization: Bearer gsp_live_…
AgentsCursor, Claude Code, Codex, Windsurf…MCPConnect the server in one step.SkillsAgent skills for GEO + outreach.

Explore the docs

API referenceEvery endpoint, parameter and response.IntegrationsUse Getspotted from no-code and AI tools.ExamplesCopy-paste recipes for common jobs.