> ## 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 concurrent

> Suivez l’évolution des indicateurs d’un concurrent dans le temps.

Renvoie, pour un concurrent, les occurrences quotidiennes de mentions, la part de voix SELF et DIRECT, la position moyenne et le sentiment moyen des mentions.

## Paramètres de chemin

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

<ParamField path="competitorId" type="string" required>
  L’identifiant unique du concurrent
</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="topic" type="string">
  Filtre par identifiant de Topic. Accepte plusieurs valeurs séparées par des virgules (par exemple `id1,id2`).
</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>

## Exemple de requête

```bash theme={null}
curl "https://www.qwairy.co/api/v1/brands/YOUR_BRAND_ID/competitors/COMPETITOR_ID/evolution?period=7" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN"
```

## Exemple de réponse

```json theme={null}
{
  "success": true,
  "competitor": {
    "id": "competitor_01",
    "name": "Rival Labs",
    "relationship": "DIRECT"
  },
  "evolution": [
    {
      "date": "2026-07-01",
      "mentions": 5,
      "shareOfVoice": 7.2,
      "avgPosition": 2.3,
      "avgSentiment": 76.5
    },
    {
      "date": "2026-07-02",
      "mentions": 8,
      "shareOfVoice": 8.5,
      "avgPosition": 2.1,
      "avgSentiment": 78.2
    }
  ]
}
```

## Erreurs

| Statut | Code | Description |
| - | - | - |
| 401 | erreur de passerelle | Jeton d’API manquant ou invalide |
| 404 | `BRAND_NOT_FOUND` | Marque inexistante ou inaccessible |
| 404 | `COMPETITOR_NOT_FOUND` | Concurrent inexistant |
| 429 | erreur de passerelle | Limite de débit dépassée ; respectez `Retry-After` |

`avgSentiment` utilise l’échelle de sentiment des mentions de 0 à 100 et peut valoir `null`. 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.