Skip to main content
GET
List answers
Returns stored answers for monitored prompts. The list contains a text preview and response-level SELF flags; use Get Answer for full evidence.
See Entities for the complete Answer object structure, including CompetitorMention and SourceCitation details.
string
required
Bearer token. Example: Bearer qw-api-xxx

Path parameters

string
required
The unique identifier of the brand

Query parameters

number
Number of days to include. If not specified, returns all data.
string
Start date in YYYY-MM-DD. Provide it with endDate; a lone boundary is currently ignored. Choose either period or the complete date pair.
string
End date in YYYY-MM-DD. Provide it with startDate; a lone boundary is currently ignored. Do not combine the complete date pair with period.
string
Filter by AI provider. Supports comma-separated multi-select (e.g., chatgpt,claude).
string
Filter by topic ID. Supports comma-separated multi-select (e.g., id1,id2).
string
Filter by tag ID. Supports comma-separated multi-select (e.g., id1,id2).
string
Filter by prompt type: TOFU, MOFU, BOFU
boolean
Filter by presence of brand mention: true or false
boolean
Use true to require a SELF citation. The current route accepts false but does not apply an inverse filter.
number
default:"50"
Maximum number of answers to return (max: 100)
number
default:"0"
Pagination offset
string
default:"createdAt"
Field to sort by: createdAt
string
default:"desc"
Sort order: asc or desc

Response

boolean
Indicates if the request was successful
object
array

Synthetic request

Synthetic response

Filtering examples

Find answers with a SELF mention

Find answers with a SELF citation

Combine filters

The endpoint does not currently support an inverse SELF-citation filter. To find answers that mention the brand without a SELF citation, request hasSelfMention=true and filter the returned hasSelfSource field in your client.

Errors

See Rate limits for retry behavior.