List query fan-out records
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/search \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/search"
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}/search', 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
},
"searches": [
{
"query": "<string>",
"occurrences": 123,
"priority": "<string>",
"brandPresence": 123,
"competitorPresence": 123,
"competitors": [
{}
],
"uniquePrompts": 123,
"prompts": [
{}
],
"uniqueAnswers": 123,
"uniqueModels": 123,
"models": [
{}
],
"topics": [
{}
],
"tags": [
{}
],
"firstSeen": "<string>",
"lastSeen": "<string>"
}
]
}Signals
List query fan-out records
List aggregated web-search queries recorded while providers generated answers, grouped by normalized query text with presence counts and a priority label.
GET
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
search
List query fan-out records
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/search \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/search"
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}/search', 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
},
"searches": [
{
"query": "<string>",
"occurrences": 123,
"priority": "<string>",
"brandPresence": 123,
"competitorPresence": 123,
"competitors": [
{}
],
"uniquePrompts": 123,
"prompts": [
{}
],
"uniqueAnswers": 123,
"uniqueModels": 123,
"models": [
{}
],
"topics": [
{}
],
"tags": [
{}
],
"firstSeen": "<string>",
"lastSeen": "<string>"
}
]
}Returns retained web-search queries associated with stored answers. Results are grouped by normalized query text and include presence counts plus an API-defined priority label.
Results are aggregated by query (case-insensitive, trimmed). Each row represents a unique search query across all responses and providers.
GET /api/v1/brands/{brandId}/search
Path parameters
Query parameters
Start date in
YYYY-MM-DD. Provide it with endDate; a lone boundary is currently ignored. Choose either period or the complete date pair.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.Response
Show Search insight object
Show Search insight object
Priority level:
very-high (competitors present, brand absent), high (both present), medium (brand only), low (neither)Synthetic request
curl -X GET "https://www.qwairy.co/api/v1/brands/cm1234567890abcdef/search?limit=10&sort=priority" \
-H "Authorization: Bearer qw-api-your-token-here"
Synthetic response
{
"success": true,
"pagination": {
"total": 142,
"count": 2,
"limit": 10,
"offset": 0
},
"searches": [
{
"query": "enterprise analytics platforms comparison",
"occurrences": 12,
"priority": "very-high",
"brandPresence": 0,
"competitorPresence": 8,
"competitors": ["Orbit Systems"],
"uniquePrompts": 5,
"prompts": [{ "id": "prompt_analytics", "text": "Which analytics platforms are commonly compared?" }],
"uniqueAnswers": 12,
"uniqueModels": 3,
"models": ["openai-gpt-6.1-sol", "anthropic-claude-4.6-sonnet", "google-gemini-3-pro"],
"topics": ["Analytics"],
"tags": ["Comparison"],
"firstSeen": "2026-07-01T10:30:00.000Z",
"lastSeen": "2026-07-15T10:30:00.000Z"
},
{
"query": "northstar analytics pricing",
"occurrences": 5,
"priority": "medium",
"brandPresence": 3,
"competitorPresence": 0,
"competitors": [],
"uniquePrompts": 2,
"prompts": [{ "id": "prompt_pricing", "text": "What pricing information is available?" }],
"uniqueAnswers": 5,
"uniqueModels": 2,
"models": ["openai-gpt-6.1-sol", "google-gemini-3-pro"],
"topics": ["Pricing"],
"tags": [],
"firstSeen": "2026-07-05T09:15:00.000Z",
"lastSeen": "2026-07-14T09:15:00.000Z"
}
]
}
priority is a deterministic classification from brandPresence and competitorPresence. Treat it as a triage input, not as a business-impact forecast.Errors
| Status | Code | Description |
|---|---|---|
| 400 | INVALID_PARAMETER | Invalid filter, pagination, or sort value |
| 401 | gateway error | Authentication failed |
| 404 | BRAND_NOT_FOUND | Brand doesn’t exist or not accessible |
| 429 | gateway error | Rate limit exceeded; honor Retry-After |