> ## 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 questions de suivi

> Listez les questions suivantes suggérées par les fournisseurs IA après les réponses suivies, avec leur prompt source, leur réponse et leur statut de suivi.

Renvoie les questions de suivi suggérées par les fournisseurs après les réponses enregistrées, des plus récentes aux plus anciennes. Chaque ligne indique la question suggérée, sa position dans la liste du fournisseur, ses types d’intention, le prompt et la réponse sources, et si la même question est déjà un prompt suivi.

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

```http theme={null}
GET /api/v1/brands/{brandId}/follow-ups
```

## 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, selon la date de la réponse. Sans valeur, toutes les données sont renvoyées.
</ParamField>

<ParamField query="startDate" type="string">
  Date de début incluse, au format `YYYY-MM-DD`. Prime sur `period`.
</ParamField>

<ParamField query="endDate" type="string">
  Date de fin incluse, au format `YYYY-MM-DD`.
</ParamField>

<ParamField query="provider" type="string">
  Filtre par un ou plusieurs alias de fournisseurs ou identifiants de modèles, séparés par des virgules.
</ParamField>

<ParamField query="topic" type="string">
  Filtre par identifiant de Topic (keywordId). 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 source, 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 source, séparés par des virgules (par exemple `FR,BE`). 50 codes au maximum ; un code invalide renvoie `400`.
</ParamField>

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

<ParamField query="offset" type="number" default="0">
  Nombre de résultats à ignorer pour la pagination
</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 questions de suivi correspondant aux filtres</ResponseField>
    <ResponseField name="count" type="number">Nombre de questions de suivi 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>
    <ResponseField name="hasMore" type="boolean">Indique si une autre page est disponible</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="followUps" type="array">
  <Expandable title="Objet question de suivi">
    <ResponseField name="id" type="string">Identifiant de la question de suivi</ResponseField>
    <ResponseField name="text" type="string">La question suggérée, ou le message de suite guidée</ResponseField>
    <ResponseField name="kind" type="string">`SUGGESTION` pour un prompt que le moteur propose tel quel ; `GUIDED_CONTINUATION` pour le message que ChatGPT envoie une fois rempli le formulaire qu’il affiche, chaque champ étant écrit sous la forme `{placeholder}`</ResponseField>
    <ResponseField name="position" type="number">Position de la suggestion dans la liste du fournisseur</ResponseField>
    <ResponseField name="types" type="array">Types d’intention, comme `COMPARISON` ou `HOW_TO` ; vide tant que la question n’est pas classée</ResponseField>
    <ResponseField name="isMonitored" type="boolean">Indique si la même question est déjà un prompt suivi</ResponseField>
    <ResponseField name="question" type="object">Prompt source, avec `id` et `text`</ResponseField>
    <ResponseField name="answer" type="object">Réponse source, avec `id`, `modelId` brut, `providerId` et `createdAt`</ResponseField>
    <ResponseField name="createdAt" type="string">Date d’enregistrement de la question de suivi (horodatage ISO 8601)</ResponseField>
  </Expandable>
</ResponseField>

## Exemple de requête

```bash theme={null}
curl -X GET "https://www.qwairy.co/api/v1/brands/cm1234567890abcdef/follow-ups?period=30&limit=1" \
  -H "Authorization: Bearer qw-api-your-token-here"
```

## Exemple de réponse

```json theme={null}
{
  "success": true,
  "pagination": {
    "total": 38,
    "count": 1,
    "limit": 1,
    "offset": 0,
    "hasMore": true
  },
  "followUps": [
    {
      "id": "followup_01",
      "text": "How do warehouse exports compare across analytics platforms?",
      "kind": "SUGGESTION",
      "position": 1,
      "types": ["COMPARISON"],
      "isMonitored": false,
      "question": {
        "id": "prompt_01",
        "text": "Which analytics platforms support warehouse exports?"
      },
      "answer": {
        "id": "answer_01",
        "modelId": "openai-chatgpt-core",
        "providerId": "openai",
        "createdAt": "2026-07-19T10:00:00.000Z"
      },
      "createdAt": "2026-07-19T10:00:02.000Z"
    }
  ]
}
```

## Erreurs

| Statut | Code | Description |
| - | - | - |
| 400 | `INVALID_PARAMETER` | Valeur de filtre ou de pagination invalide |
| 401 | erreur de passerelle | Échec de l’authentification |
| 404 | `BRAND_NOT_FOUND` | Marque inexistante ou inaccessible |
| 429 | erreur de passerelle | Limite de débit dépassée ; respectez `Retry-After` |


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