API reference

API reference

The Getspotted API finds the sources AI engines and Google cite for a query, plus the contacts behind them. Base URL below. All calls return { success, data } on success, or { success: false, error, code } on failure.

Base URL https://getspotted.ai/api/v1. Authenticate with Authorization: Bearer gsp_live_… (the discovery endpoints are public).

post/api/v1/search

Find AI-cited sources for a query

Runs the query across Google + ChatGPT (+ AI Overview + Perplexity/Claude/Gemini) and returns the cited sources, scored, with per-engine positions. Costs 10 credits.

post/api/v1/contacts

Find editor contacts for a source domain

Returns contact emails for a cited source domain. Costs 2 credits.

get/api/v1/engines

List supported AI engines

get/api/v1/countries

List supported markets

get/api/v1/usage

Get this key's usage + credit balance

Full OpenAPI spec

The machine-readable OpenAPI 3.1 document lives at /openapi.json — point any client generator or agent at it.