> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Évolution d’un Topic

> Indicateurs quotidiens en série temporelle pour un Topic précis.

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.

<ParamField header="Authorization" type="string" required>
  Jeton bearer. Exemple : `Bearer qw-api-xxx`
</ParamField>

## Paramètres de chemin

<ParamField path="brandId" type="string" required>
  L’identifiant unique de la marque
</ParamField>

<ParamField path="keywordId" type="string" required>
  L’identifiant unique du Topic
</ParamField>

## Paramètres de requête

<ParamField query="period" type="number">
  Nombre de jours à inclure. Sans valeur, toutes les données sont renvoyées.
</ParamField>

<ParamField query="startDate" type="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.
</ParamField>

<ParamField query="endDate" type="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`.
</ParamField>

<ParamField query="provider" type="string">
  Filtre par fournisseur IA. Accepte plusieurs valeurs séparées par des virgules (par exemple `chatgpt,claude`).
</ParamField>

<ParamField query="tag" type="string">
  Filtre par identifiant de Tag. Accepte plusieurs valeurs séparées par des virgules (par exemple `id1,id2`).
</ParamField>

<ParamField query="type" type="string">
  Filtre par type de prompt : `TOFU`, `MOFU`, `BOFU` ou `POST_PURCHASE`
</ParamField>

## Réponse

<ResponseField name="success" type="boolean">
  Indique si la requête a réussi
</ResponseField>

<ResponseField name="keyword" type="object">
  <Expandable title="Informations du Topic">
    <ResponseField name="id" type="string">Identifiant du Topic</ResponseField>
    <ResponseField name="text" type="string">Texte du Topic</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="evolution" type="array">
  <Expandable title="Indicateurs quotidiens">
    <ResponseField name="date" type="string">Date (format YYYY-MM-DD)</ResponseField>
    <ResponseField name="answers" type="number">Réponses enregistrées à cette date</ResponseField>
    <ResponseField name="mentionRate" type="number">Réponses avec une mention SELF divisées par les réponses avec une mention SELF ou DIRECT</ResponseField>
    <ResponseField name="shareOfVoice" type="number">Occurrences de mentions SELF divisées par les occurrences de mentions SELF et DIRECT</ResponseField>
    <ResponseField name="avgSentiment" type="number | null">Sentiment moyen des mentions SELF sur une échelle de 0 à 100, ou `null`</ResponseField>
    <ResponseField name="sourceRate" type="number">Réponses avec une citation SELF divisées par les réponses avec une citation SELF ou DIRECT</ResponseField>
  </Expandable>
</ResponseField>

## Exemple de requête

```bash theme={null}
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

```json theme={null}
{
  "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` |

Consultez [Limites de débit](/fr/developers/rate-limits) pour la gestion des nouvelles tentatives.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.