Docs Sign inGet started
API reference · Answers

List sources

Cited domains and URLs (view=gap for outreach targets).

Ask Claude Ask ChatGPT
GET/api/v1/domains/{domain}/sources

Path parameters

domainstringRequired

The domain's host, like acme.example, or its ID. List them with List domains.

Query parameters

viewstringdefault all

all, or gap: third-party sites cited in answers that name a competitor but not you.

allgap
rangestringdefault 30d

How far back to count: 7d, 30d, 90d or all. The previous period is the same length, just before.

7d30d90dall
surfacestring

Limit to one surface, written engine:lane, e.g. chatgpt_app:chat.

topicstring

Limit to prompts in one topic (exact name).

brandedstringdefault unbranded

Whether to count prompts that name your brand: unbranded (default), all or branded.

unbrandedallbranded

Returns

typesarray

Answers citing each kind of source.

sources[].hoststring

The cited site.

sources[].kindstring

you, competitor or other.

sources[].typestring

Yours, Competitor, UGC & community, Reviews & directories, Reference or Editorial & other.

sources[].answersinteger

Answers citing it.

sources[].sharenumber

Those answers as a share of all answers.

sources[].with_youinteger

Answers citing it that also name you.

sources[].gapinteger

Answers citing it that name a competitor but not you.

sources[].trendstring or null

new, up, down or flat against the previous period.

sources[].urlsarray

Top URLs on the site, as {url, count}.

Every response includes the domain and the filters that were applied. Errors use the standard error object.