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

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

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

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

<ParamField path="promptId" type="string" required>
  L’identifiant unique du prompt
</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>

## Exemple de requête

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

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