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

# Obtenir une réponse

> Récupérez une réponse IA avec son texte complet et son analyse détaillée.

Récupère une réponse enregistrée avec son prompt, les libellés de fournisseur et de modèle, les mentions détectées, les citations, les requêtes Query Fan-Out et le sentiment SELF.

<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="answerId" type="string" required>
  L’identifiant unique de la réponse
</ParamField>

## Réponse

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

<ResponseField name="answer" type="object">
  <Expandable title="Détail complet de la réponse">
    <ResponseField name="id" type="string">Identifiant de la réponse</ResponseField>

    <ResponseField name="prompt" type="object">
      Informations du prompt associé (id, texte, Topic, type)
    </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="text" type="string">Texte complet de la réponse</ResponseField>

    <ResponseField name="competitors" type="array">
      Liste des concurrents mentionnés, avec position, relation et sentiment
    </ResponseField>

    <ResponseField name="sources" type="array">
      Liste des sources citées, avec URL, domaine, position et indicateur isSelf
    </ResponseField>

    <ResponseField name="queryFanOuts" type="array">
      Requêtes de recherche enregistrées, avec `id`, `query`, identifiant `model` brut et `createdAt`
    </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</ResponseField>
  </Expandable>
</ResponseField>

## Exemple de requête

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

## Exemple de réponse

```json theme={null}
{
  "success": true,
  "answer": {
    "id": "answer_01",
    "prompt": {
      "id": "prompt_01",
      "text": "Which analytics platforms support warehouse exports?",
      "topic": "Data exports",
      "type": "TOFU"
    },
    "provider": "ChatGPT",
    "model": "GPT-6.1 Sol",
    "text": "Acme Analytics and Rival Labs both document warehouse export integrations.",
    "competitors": [
      {
        "name": "Acme Analytics",
        "position": 3,
        "relationship": "SELF",
        "sentiment": 85
      },
      {
        "name": "Rival Labs",
        "position": 1,
        "relationship": "DIRECT",
        "sentiment": 80
      }
    ],
    "sources": [
      {
        "url": "https://publisher.example/warehouse-export-comparison",
        "domain": "publisher.example",
        "position": 1,
        "isSelf": false
      },
      {
        "url": "https://acme.example/integrations",
        "domain": "acme.example",
        "position": 2,
        "isSelf": true
      }
    ],
    "queryFanOuts": [
      {
        "id": "search_01",
        "query": "analytics warehouse export integrations",
        "model": "openai-gpt-6.1-sol",
        "createdAt": "2026-07-19T09:59:58.000Z"
      }
    ],
    "sentiment": 82,
    "createdAt": "2026-07-19T10:00:00.000Z"
  }
}
```

## Erreurs

| Statut | Code | Description |
| - | - | - |
| 401 | erreur de passerelle | Jeton d’API manquant ou invalide |
| 404 | `BRAND_NOT_FOUND` | Marque inexistante ou inaccessible |
| 404 | `ANSWER_NOT_FOUND` | Réponse inexistante |
| 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.