Skip to main content
GET
Get citation statistics by domain
See the Analyzing with statistics guide for real examples and interpretation.

FAQ

The result is empty. Either the run is still in progress, or no successful answer in the specified scope provided sources.

Authorizations

API-Key
string
header
required

"Enter your organization API key. Example: 'cs_live_xxxx'"

Query Parameters

runIDs
string[]

Prompt run filter (IDs issued when the run request was made, repeatable, up to 5; multiple values are combined as a union). At least one of runIDs or promptIDs is required

promptIDs
string[]

Prompt filter (the id from the prompt list or create response, repeatable, up to 10; multiple values are combined as a union). At least one of runIDs or promptIDs is required

model
enum<string>

Model filter. Only models retrievable from GET /models are allowed

Available options:
CHATGPT,
GOOGLE_OVERVIEW,
GOOGLE_AI,
PERPLEXITY,
GEMINI,
NAVER_AI_BRIEFING,
NAVER_AI_TAB,
CLAUDE,
META_MUSE,
BAIDU_AI_SEARCH,
GROK,
BAIDU_AI_TAB,
DEEPSEEK
domains
string[]

Domain filter (repeatable, up to 50, each up to 253 characters). Matching follows groupBy. Specifying domains outside the top limit lets you see their metrics as well

groupBy
enum<string>

Aggregation unit (default domain=aggregated by root domain, subdomain=split by subdomain). www. is always stripped and merged into the parent domain

Available options:
domain,
subdomain
include
string[]

Additional fields to include. Passing models also returns the per-domain model breakdown

limit
integer

How many top domains to return (default 50, maximum 200)

Response

OK

domains
object[]

Domain ranking by citation count in descending order (top limit entries)

totalCitations
integer

Total number of citations in the scope (if the same URL is cited in multiple answers, each counts as 1)

Example:

1571

totalDomains
integer

Number of unique domains in the scope (based on the statistics unit, excluding citations with an unresolved domain). null if there are too many distinct domains to count exactly

Example:

354