Sign in

v4

Swagger 2.0Proprietary2026-08-0173264.4 KB
Dimensions

List source URLs

get/dimensions/sources

Query parameters

project_idinteger required

Project ID

pageinteger
per_pageinteger
model'chatgpt' | 'perplexity' | 'gemini' | 'ai_overview' | 'ai_mode' | 'copilot' | 'claude' | 'grok' | 'deepseek' | 'meta_ai' | 'amazon_rufus'

Filter by AI model. Models the API key's user has not enabled are silently dropped.

collection_idinteger
country_codestring
language_codestring
promptinteger
fromstring date-time
tostring date-time
source_type'owned' | 'competitor' | 'third_party'

Owned and competitor matching honor the project's exact-subdomain setting.

mention_filter'mentions_you' | 'not_mentions_you' | 'mentions_competitor' | 'not_mentions_competitor' | 'you_and_competitor' | 'competitor_not_you' | 'you_not_competitor' | 'no_brands'

Filter by which brands are mentioned, as a two-axis matrix (your brand x competitors). The four combined cells are you_and_competitor, competitor_not_you (a rival wins and you are absent), you_not_competitor and no_brands (no tracked brand appears). Combine with competitors to narrow the competitor side; on a negative cell that reads none of these. On /dimensions/sources it applies to the crawled content of each cited page. The legacy value competitors_only is accepted as an alias of competitor_not_you.

competitorsstring

Comma-separated competitor IDs

output'flat' | 'csv'

Rectangular output for BI tools (Tableau, Excel, Sheets, ELT). Omit for the default nested JSON. 'flat' returns the same metadata plus 'columns' and 'rows'; 'csv' returns those rows as text/csv. Errors are always returned as JSON.

Response

Paginated sources