DOCS

List cited domains

GET/v1/citations

The domains AI answers cite for a brand’s prompts over a period, most cited first, and how often they’re cited next to you.

Read-onlyAll plans

Query parameters

brand_idstringoptionalThe brand to read. Optional when your key covers one brand; required for agency keys and when trying the API signed in.
start_datedateoptionalFirst day, YYYY-MM-DD. Default: 30 days ago.
end_datedateoptionalLast day, inclusive. Default: today. At most 365 days after start_date.
typeenumoptionalOnly this kind of source.ownedcompetitorreviewearnedugc
limitintegeroptionalHow many items to return, 1 to 100. Default 20.

Response

A list of cited_domain objects.

objectstringAlways list.
dataarray of objectsThe items.
domainstringThe domain.
typestringIts usual kind of source.
citationsintegerHow many times it was cited.
answers_with_youintegerCiting answers that also mention you.
has_morebooleanWhether there is another page.
next_cursorstring or nullPass as cursor to get the next page.

Errors

401unauthorizedMissing or revoked API key.
404not_foundNo brand with that id that this key can read.
429rate_limitedToo many requests; see Retry-After.