Prompt evolution
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/prompts/{promptId}/evolution \
--header 'Authorization: Bearer <token>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/prompts/{promptId}/evolution"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/prompts/{promptId}/evolution', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Prompts
Prompt evolution
Track how a prompt’s response-level metrics change over time with daily values, including Mention Rate and Source Rate for eligible SELF or DIRECT answers.
GET
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
prompts
/
{promptId}
/
evolution
Prompt evolution
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/prompts/{promptId}/evolution \
--header 'Authorization: Bearer <token>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/prompts/{promptId}/evolution"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/prompts/{promptId}/evolution', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Returns daily response-level metrics for one prompt. Mention Rate and Source Rate use eligible SELF-or-DIRECT answer denominators.
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.Synthetic request
curl "https://www.qwairy.co/api/v1/brands/YOUR_BRAND_ID/prompts/PROMPT_ID/evolution?period=7" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN"
Synthetic response
{
"success": true,
"prompt": {
"id": "prompt_01",
"text": "Which analytics platforms support warehouse exports?"
},
"evolution": [
{
"date": "2026-07-01",
"answers": 5,
"mentionRate": 80.0,
"sourceRate": 60.0,
"avgSentiment": 78.5
},
{
"date": "2026-07-02",
"answers": 8,
"mentionRate": 75.0,
"sourceRate": 62.5,
"avgSentiment": 80.1
}
]
}
Errors
| Status | Code | Description |
|---|---|---|
| 400 | INVALID_PARAMETER | Invalid query parameter |
| 401 | gateway error | Missing or invalid API token |
| 404 | BRAND_NOT_FOUND | Brand doesn’t exist or not accessible |
| 404 | PROMPT_NOT_FOUND | Prompt doesn’t exist |
| 429 | gateway error | Rate limit exceeded; honor Retry-After |
mentionRate is answers with a SELF mention divided by answers with a SELF or DIRECT mention. sourceRate applies the same response-level denominator rule to citations. avgSentiment is on the 0 to 100 scale and can be null. See Rate limits for retry behavior.
