Skip to main content
GET
Get Competitor Citations

Authorizations

Authorization
string
header
required

Personal API key created in the dashboard (Settings > API keys).

Headers

authorization
string | null

Bearer <api_key>

X-MCP-Secret
string | null

Query Parameters

time_range
enum<string> | null
Available options:
all_time,
1y,
1m,
1w,
1d
platforms[]
enum<string>[] | null
Available options:
ChatGPT,
Gemini,
AI Overviews,
Google AI Mode,
Perplexity,
Mistral,
Claude,
DeepSeek,
Grok,
Copilot
localizations[]
string[] | null
topic_ids[]
integer[] | null
website_id
integer
required

Target website id

Response

Successful Response

Response with citation counts per entity for a time range.

others_count = citations where neither the website nor any active (in-plan) competitor was cited. Used by the competitors-page donut as a dedicated slice so the chart denominator stays coherent without front-side arithmetic on total_citations.

entities
EntityCitationCount · object[]
required
total_citations
integer
required
others_count
integer
required