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

# Lister les réponses

> Récupérez les réponses générées par l’IA, filtrées par fournisseur, mentions de la marque et sources.

Renvoie les réponses enregistrées des prompts suivis. La liste contient un aperçu du texte et les indicateurs SELF au niveau de la réponse ; utilisez [Obtenir une réponse](/fr/developers/endpoints/answers/get) pour le détail complet.

<Note>
  Consultez [Entités](/fr/developers/entities#answer) pour la structure complète de l’objet Answer, y compris le détail de [CompetitorMention](/fr/developers/entities#competitor-mention) et de [SourceCitation](/fr/developers/entities#source-citation).
</Note>

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

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

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

<ParamField query="personaIds" type="string">
  UUID de Personas enregistrées sur la réponse, séparés par des virgules. Utilisez `default` pour les réponses générées sans Persona, ou `all` pour ne pas filtrer.
</ParamField>

<ParamField query="countries" type="string">
  Codes ISO 3166-1 alpha-2 du pays enregistré sur la réponse, séparés par des virgules (par exemple `FR,BE`). 50 codes au maximum ; un code invalide renvoie `400`.
</ParamField>

<ParamField query="hasSelfMention" type="boolean">
  Filtre selon la présence d’une mention de la marque : `true` ou `false`
</ParamField>

<ParamField query="hasSelfSource" type="boolean">
  Utilisez `true` pour exiger une citation SELF. La route actuelle accepte `false` mais n’applique pas de filtre inverse.
</ParamField>

<ParamField query="limit" type="number" default="50">
  Nombre maximal de réponses renvoyées (maximum : 100)
</ParamField>

<ParamField query="offset" type="number" default="0">
  Décalage de pagination
</ParamField>

<ParamField query="sort" type="string" default="createdAt">
  Champ de tri : `createdAt`
</ParamField>

<ParamField query="order" type="string" default="desc">
  Ordre de tri : `asc` ou `desc`
</ParamField>

## Réponse

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

<ResponseField name="pagination" type="object">
  <Expandable title="Informations de pagination">
    <ResponseField name="total" type="number">Nombre total de réponses correspondant aux filtres</ResponseField>
    <ResponseField name="count" type="number">Nombre de réponses dans cette réponse</ResponseField>
    <ResponseField name="limit" type="number">Nombre maximal d’éléments par page</ResponseField>
    <ResponseField name="offset" type="number">Nombre d’éléments ignorés</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="answers" type="array">
  <Expandable title="Résumé de la réponse">
    <ResponseField name="id" type="string">Identifiant de la réponse</ResponseField>
    <ResponseField name="promptId" type="string">Identifiant du prompt associé</ResponseField>
    <ResponseField name="promptText" type="string">Texte du prompt associé</ResponseField>
    <ResponseField name="provider" type="string">Nom du fournisseur IA</ResponseField>
    <ResponseField name="model" type="string">Nom du modèle IA</ResponseField>
    <ResponseField name="persona" type="object | null">Persona enregistrée lors de la génération de la réponse (`id`, `name`, `description`), ou `null`</ResponseField>
    <ResponseField name="textPreview" type="string">200 premiers caractères de la réponse</ResponseField>
    <ResponseField name="hasSelfMention" type="boolean">Indique si la marque est mentionnée</ResponseField>
    <ResponseField name="selfMentionPosition" type="number">Position dans la liste des mentions (si elle est mentionnée)</ResponseField>
    <ResponseField name="hasSelfSource" type="boolean">Indique si le domaine de la marque est cité</ResponseField>
    <ResponseField name="competitorsCount" type="number">Nombre de concurrents mentionnés</ResponseField>
    <ResponseField name="sourcesCount" type="number">Nombre de sources citées</ResponseField>
    <ResponseField name="sentiment" type="number | null">Sentiment de la mention SELF sur une échelle de 0 à 100, ou `null`</ResponseField>
    <ResponseField name="createdAt" type="string">Horodatage de génération (ISO 8601)</ResponseField>
  </Expandable>
</ResponseField>

## Exemple de requête

```bash theme={null}
curl "https://www.qwairy.co/api/v1/brands/YOUR_BRAND_ID/answers?hasSelfMention=true&limit=10" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN"
```

## Exemple de réponse

```json theme={null}
{
  "success": true,
  "pagination": {
    "total": 312,
    "count": 1,
    "limit": 10,
    "offset": 0
  },
  "answers": [
    {
      "id": "answer_01",
      "promptId": "prompt_01",
      "promptText": "Which analytics platforms support warehouse exports?",
      "provider": "ChatGPT",
      "model": "GPT-6.1 Sol",
      "textPreview": "Acme Analytics and Rival Labs both document warehouse export integrations...",
      "hasSelfMention": true,
      "selfMentionPosition": 3,
      "hasSelfSource": false,
      "competitorsCount": 5,
      "sourcesCount": 3,
      "sentiment": 82,
      "createdAt": "2026-07-19T10:00:00.000Z"
    }
  ]
}
```

## Exemples de filtres

### Trouver les réponses avec une mention SELF

```bash theme={null}
GET /api/v1/brands/{brandId}/answers?hasSelfMention=true
```

### Trouver les réponses avec une citation SELF

```bash theme={null}
GET /api/v1/brands/{brandId}/answers?hasSelfSource=true
```

### Combiner des filtres

```bash theme={null}
# Answers with a SELF mention from the ChatGPT provider
GET /api/v1/brands/{brandId}/answers?provider=openai&hasSelfMention=true
```

L’endpoint ne prend pas encore en charge de filtre inverse sur la citation SELF. Pour trouver les réponses qui mentionnent la marque sans la citer, demandez `hasSelfMention=true` et filtrez le champ `hasSelfSource` renvoyé dans votre client.

## Erreurs

| Statut | Signification |
| - | - |
| `400` | Paramètre de requête invalide |
| `401` | Jeton d’API manquant ou invalide |
| `404` | Marque introuvable ou inaccessible |
| `429` | 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.