Évolution d’un Topic
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/keywords/{keywordId}/evolution \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/keywords/{keywordId}/evolution"
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}/keywords/{keywordId}/evolution', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"keyword": {
"id": "<string>",
"text": "<string>"
},
"evolution": [
{
"date": "<string>",
"answers": 123,
"mentionRate": 123,
"shareOfVoice": 123,
"avgSentiment": {},
"sourceRate": 123
}
]
}Topics
Évolution d’un Topic
Indicateurs quotidiens en série temporelle pour un Topic précis.
GET
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
keywords
/
{keywordId}
/
evolution
Évolution d’un Topic
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/keywords/{keywordId}/evolution \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/keywords/{keywordId}/evolution"
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}/keywords/{keywordId}/evolution', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"keyword": {
"id": "<string>",
"text": "<string>"
},
"evolution": [
{
"date": "<string>",
"answers": 123,
"mentionRate": 123,
"shareOfVoice": 123,
"avgSentiment": {},
"sourceRate": 123
}
]
}Renvoie les indicateurs quotidiens au niveau des réponses pour un Topic. Le taux de mention et le taux de citation utilisent comme dénominateur les réponses éligibles SELF ou DIRECT ; la part de voix utilise les occurrences de mentions.
Consultez Limites de débit pour la gestion des nouvelles tentatives.
string
requis
Jeton bearer. Exemple :
Bearer qw-api-xxxParamètres de chemin
string
requis
L’identifiant unique de la marque
string
requis
L’identifiant unique du Topic
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).string
Filtre par type de prompt :
TOFU, MOFU, BOFU ou POST_PURCHASERéponse
boolean
Indique si la requête a réussi
array
Afficher Indicateurs quotidiens
Afficher Indicateurs quotidiens
string
Date (format YYYY-MM-DD)
number
Réponses enregistrées à cette date
number
Réponses avec une mention SELF divisées par les réponses avec une mention SELF ou DIRECT
number
Occurrences de mentions SELF divisées par les occurrences de mentions SELF et DIRECT
number | null
Sentiment moyen des mentions SELF sur une échelle de 0 à 100, ou
nullnumber
Réponses avec une citation SELF divisées par les réponses avec une citation SELF ou DIRECT
Exemple de requête
curl "https://www.qwairy.co/api/v1/brands/YOUR_BRAND_ID/keywords/TOPIC_ID/evolution?period=30" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN"
Exemple de réponse
{
"success": true,
"keyword": {
"id": "topic_01",
"text": "data exports"
},
"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
}
]
}
Erreurs
| Statut | Code | Description |
|---|---|---|
| 401 | erreur de passerelle | Jeton d’API manquant ou invalide |
| 404 | BRAND_NOT_FOUND | Marque inexistante ou inaccessible |
| 404 | KEYWORD_NOT_FOUND | Topic inexistant ou inaccessible |
| 429 | erreur de passerelle | Limite de débit dépassée ; respectez Retry-After |

