Évolution d’un prompt
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
Évolution d’un prompt
Suivez l’évolution des indicateurs d’un prompt dans le temps.
GET
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
prompts
/
{promptId}
/
evolution
Évolution d’un prompt
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));Renvoie les indicateurs quotidiens au niveau des réponses pour un prompt. Le taux de mention et le taux de citation utilisent comme dénominateur les réponses éligibles SELF ou DIRECT.
Paramètres de chemin
string
requis
L’identifiant unique de la marque
string
requis
L’identifiant unique du prompt
Paramètres de requête
number
Nombre de jours à inclure. Sans valeur, toutes les données sont renvoyées.
string
Date de début au format
YYYY-MM-DD. Fournissez-la avec endDate ; une borne seule est actuellement ignorée. Choisissez soit period, soit la paire de dates complète.string
Date de fin au format
YYYY-MM-DD. Fournissez-la avec startDate ; une borne seule est actuellement ignorée. Ne combinez pas la paire de dates complète avec period.string
Filtre par fournisseur IA. Accepte plusieurs valeurs séparées par des virgules (par exemple
chatgpt,claude).string
Filtre par identifiant de Tag. Accepte plusieurs valeurs séparées par des virgules (par exemple
id1,id2).Exemple de requête
curl "https://www.qwairy.co/api/v1/brands/YOUR_BRAND_ID/prompts/PROMPT_ID/evolution?period=7" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN"
Exemple de réponse
{
"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
}
]
}
Erreurs
| Statut | Code | Description |
|---|---|---|
| 400 | INVALID_PARAMETER | Paramètre de requête invalide |
| 401 | erreur de passerelle | Jeton d’API manquant ou invalide |
| 404 | BRAND_NOT_FOUND | Marque inexistante ou inaccessible |
| 404 | PROMPT_NOT_FOUND | Prompt inexistant |
| 429 | erreur de passerelle | Limite de débit dépassée ; respectez Retry-After |
mentionRate correspond aux réponses avec une mention SELF divisées par les réponses avec une mention SELF ou DIRECT. sourceRate applique la même règle de dénominateur aux citations. avgSentiment est sur l’échelle de 0 à 100 et peut valoir null. Consultez Limites de débit pour la gestion des nouvelles tentatives.