API reference · Answers

List answers

Answers behind the numbers, newest first.

Ask Claude Ask ChatGPT

GET/api/v1/domains/{domain}/answers

Path parameters

domainstringRequired

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

Query parameters

showstring

missing: a tracked competitor is named and you aren't. mentioned: you're named. Empty for all.

missingmentioned

searchstring

Case-insensitive text to find in the prompt or answer.

limitintegerdefault 50

Answers per page, 1 to 200.

offsetintegerdefault 0

Answers to skip. Use next_offset from the previous page.

include_textbooleandefault false

Include the full answer text, search queries and model.

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

totalinteger

Answers matching the filters.

next_offsetinteger or null

Pass as offset for the next page; null on the last page.

answers[].idstring

The answer's ID.

answers[].run_datestring

The run's date (YYYY-MM-DD, UTC).

answers[].surfacestring

Where it came from, as engine:lane.

answers[].methodstring

app (captured from the consumer app) or api.

answers[].named_youboolean

Whether the answer names your brand.

answers[].your_positioninteger or null

Your rank among brands named.

answers[].brandsarray

Every brand named, in order.

answers[].citationsarray

Cited URLs, in order.

answers[].textstring

Only with include_text=true: the full answer, plus fan_out_queries and model.

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