Track how your brand performs across different keywords and topics. Keywords are the semantic themes that organize your monitoring prompts.
See Entities for the complete Keyword object structure. List Keywords
Bearer token. Example: Bearer qw-api-xxx
GET /api/v1/brands/{brandId}/keywords
Path Parameters
The unique identifier of the brand
Query Parameters
Number of days to include. If not specified, returns all data.
Start date (ISO 8601 format)
End date (ISO 8601 format)
Filter by AI provider. Supports comma-separated multi-select (e.g., chatgpt,claude).
Filter by tag ID. Supports comma-separated multi-select (e.g., id1,id2).
Maximum number of keywords to return (max: 100)
Number of results to skip for pagination
Field to sort by: prompts, answers, mentionRate, shareOfVoice, sentiment, keyword
Response
Indicates if the request was successful
Total number of keywords matching filters
Number of keywords in this response
Number of prompts with this keyword
Total AI responses analyzed
Percentage of responses mentioning brand (0-100)
Brand mentions vs competitors (0-100)
Average sentiment score (0-100)
Example Request
curl -X GET "https://www.qwairy.co/api/v1/brands/cm1234567890abcdef/keywords?limit=10" \
-H "Authorization: Bearer qw-api-your-token-here"
Example Response
{
"success": true,
"pagination": {
"total": 25,
"count": 2,
"limit": 10,
"offset": 0
},
"keywords": [
{
"id": "kw1",
"keyword": "best CRM software",
"totalPrompts": 15,
"totalAnswers": 120,
"brandMentionRate": 45.5,
"shareOfVoice": 32.1,
"avgSentiment": 78.3
},
{
"id": "kw2",
"keyword": "enterprise solutions",
"totalPrompts": 8,
"totalAnswers": 64,
"brandMentionRate": 28.1,
"shareOfVoice": 18.5,
"avgSentiment": 72.0
}
]
}
Error Responses
| Status | Code | Description |
|---|
| 401 | INVALID_TOKEN | Authentication failed |
| 404 | BRAND_NOT_FOUND | Brand doesn’t exist or not accessible |
Keyword Evolution
Bearer token. Example: Bearer qw-api-xxx
GET /api/v1/brands/{brandId}/keywords/{keywordId}/evolution
Path Parameters
The unique identifier of the brand
The unique identifier of the keyword
Query Parameters
Number of days to include. If not specified, returns all data.
Start date (ISO 8601 format)
End date (ISO 8601 format)
Filter by AI provider. Supports comma-separated multi-select (e.g., chatgpt,claude).
Filter by tag ID. Supports comma-separated multi-select (e.g., id1,id2).
Filter by prompt type: TOFU, MOFU, BOFU
Response
Indicates if the request was successful
Number of AI responses analyzed
Percentage of responses mentioning brand (0-100)
Brand mentions vs competitors (0-100)
Percentage of responses citing brand sources (0-100)
Example Request
curl -X GET "https://www.qwairy.co/api/v1/brands/cm1234567890abcdef/keywords/kw1/evolution?period=30" \
-H "Authorization: Bearer qw-api-your-token-here"
Example Response
{
"success": true,
"keyword": {
"id": "kw1",
"text": "best CRM software"
},
"evolution": [
{
"date": "2026-02-15",
"answers": 42,
"mentionRate": 65.2,
"shareOfVoice": 48.3,
"avgSentiment": 72.1,
"sourceRate": 55.0
},
{
"date": "2026-02-16",
"answers": 38,
"mentionRate": 60.5,
"shareOfVoice": 45.1,
"avgSentiment": 74.2,
"sourceRate": 52.6
}
]
}
Error Responses
| Status | Code | Description |
|---|
| 401 | INVALID_TOKEN | Authentication failed |
| 404 | BRAND_NOT_FOUND | Brand doesn’t exist or not accessible |
| 404 | KEYWORD_NOT_FOUND | Keyword doesn’t exist or not accessible |
