List answers
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/answers \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/answers"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/answers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"pagination": {
"total": 123,
"count": 123,
"limit": 123,
"offset": 123
},
"answers": [
{
"id": "<string>",
"promptId": "<string>",
"promptText": "<string>",
"provider": "<string>",
"model": "<string>",
"textPreview": "<string>",
"hasSelfMention": true,
"selfMentionPosition": 123,
"hasSelfSource": true,
"competitorsCount": 123,
"sourcesCount": 123,
"sentiment": {},
"createdAt": "<string>"
}
]
}Answers
List answers
Retrieve AI-generated responses with filters for provider, brand mentions, and sources.
GET
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
answers
List answers
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/answers \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/answers"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/answers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"pagination": {
"total": 123,
"count": 123,
"limit": 123,
"offset": 123
},
"answers": [
{
"id": "<string>",
"promptId": "<string>",
"promptText": "<string>",
"provider": "<string>",
"model": "<string>",
"textPreview": "<string>",
"hasSelfMention": true,
"selfMentionPosition": 123,
"hasSelfSource": true,
"competitorsCount": 123,
"sourcesCount": 123,
"sentiment": {},
"createdAt": "<string>"
}
]
}Returns stored answers for monitored prompts. The list contains a text preview and response-level SELF flags; use Get Answer for full evidence.
The endpoint does not currently support an inverse SELF-citation filter. To find answers that mention the brand without a SELF citation, request
See Rate limits for retry behavior.
See Entities for the complete Answer object structure, including CompetitorMention and SourceCitation details.
string
required
Bearer token. Example:
Bearer qw-api-xxxPath 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, BOFUboolean
Filter by presence of brand mention:
true or falseboolean
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:
createdAtstring
default:"desc"
Sort order:
asc or descResponse
boolean
Indicates if the request was successful
object
array
Show Answer summary
Show Answer summary
string
Answer ID
string
Associated prompt ID
string
Associated prompt text
string
AI provider name
string
AI model name
string
First 200 characters of the response
boolean
Whether brand is mentioned
number
Position in mention list (if mentioned)
boolean
Whether brand domain is cited
number
Number of competitors mentioned
number
Number of sources cited
number | null
SELF mention sentiment on a 0 to 100 scale, or
nullstring
Generation timestamp (ISO 8601)
Synthetic request
curl "https://www.qwairy.co/api/v1/brands/YOUR_BRAND_ID/answers?hasSelfMention=true&limit=10" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN"
Synthetic response
{
"success": true,
"pagination": {
"total": 312,
"count": 1,
"limit": 10,
"offset": 0
},
"answers": [
{
"id": "answer_01",
"promptId": "prompt_01",
"promptText": "Which analytics platforms support warehouse exports?",
"provider": "ChatGPT",
"model": "GPT-5.4",
"textPreview": "Acme Analytics and Rival Labs both document warehouse export integrations...",
"hasSelfMention": true,
"selfMentionPosition": 3,
"hasSelfSource": false,
"competitorsCount": 5,
"sourcesCount": 3,
"sentiment": 82,
"createdAt": "2026-07-19T10:00:00.000Z"
}
]
}
Filtering examples
Find answers with a SELF mention
GET /api/v1/brands/{brandId}/answers?hasSelfMention=true
Find answers with a SELF citation
GET /api/v1/brands/{brandId}/answers?hasSelfSource=true
Combine filters
# Answers with a SELF mention from the ChatGPT provider
GET /api/v1/brands/{brandId}/answers?provider=openai&hasSelfMention=true
hasSelfMention=true and filter the returned hasSelfSource field in your client.
Errors
| Status | Meaning |
|---|---|
400 | Invalid query parameter |
401 | Missing or invalid API token |
404 | Brand not found or inaccessible |
429 | Rate limit exceeded; honor Retry-After |

