> ## 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 un instantané de perception

> Récupérez un instantané de perception terminé, avec scores, alignement des attributs et observations SWOT.

Renvoie un instantané de perception terminé. Récupérez `snapshotId` dans le tableau `history` renvoyé par [Lister les instantanés de perception](/fr/developers/endpoints/perception/list).

<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="snapshotId" type="string" required>
  L’identifiant unique de l’instantané de perception
</ParamField>

## Réponse

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

<ResponseField name="brand" type="object">
  `id`, `name`, `domain`
</ResponseField>

<ResponseField name="snapshot" type="object">
  <Expandable title="Instantané">
    <ResponseField name="snapshotId" type="string">Identifiant de l’instantané</ResponseField>
    <ResponseField name="month" type="number">Mois (1 à 12)</ResponseField>
    <ResponseField name="year" type="number">Année</ResponseField>
    <ResponseField name="scores" type="object">`sentiment`, `alignment`, `consistency`, `factualAlignment` (0 à 100 ou `null`)</ResponseField>

    <ResponseField name="attributes" type="array">
      Attributs de la marque évalués par l’IA. Chaque objet a un `text` (string) et un `status` (`aligned`, `partial`, `missing`).
    </ResponseField>

    <ResponseField name="attributeMetrics" type="object">
      Nombres : `aligned`, `partial`, `missing`, `total`.
    </ResponseField>

    <ResponseField name="insights" type="object">
      Tableaux SWOT de chaînes : `strengths`, `weaknesses`, `opportunities`, `threats`.
    </ResponseField>

    <ResponseField name="providers" type="array">Fournisseurs IA inclus dans l’analyse</ResponseField>
    <ResponseField name="createdAt" type="string">Horodatage de création (ISO 8601)</ResponseField>
    <ResponseField name="completedAt" type="string">Horodatage de fin (ISO 8601) ou `null`</ResponseField>
  </Expandable>
</ResponseField>

Un `404 RESOURCE_NOT_FOUND` est renvoyé si l’instantané n’existe pas, n’est pas `COMPLETED` ou n’appartient pas à la marque.

## Exemple de requête

```bash theme={null}
curl -X GET "https://www.qwairy.co/api/v1/brands/cm1234567890abcdef/perception/snap_2026_05" \
  -H "Authorization: Bearer qw-api-your-token-here"
```

## Exemple de réponse

```json theme={null}
{
  "success": true,
  "brand": {
    "id": "cm1234567890abcdef",
    "name": "Northstar Labs",
    "domain": "northstar.example"
  },
  "snapshot": {
    "snapshotId": "snap_2026_05",
    "month": 5,
    "year": 2026,
    "scores": {
      "sentiment": 78,
      "alignment": 65,
      "consistency": 82,
      "factualAlignment": 71
    },
    "attributes": [
      { "text": "Premium positioning", "status": "aligned" },
      { "text": "Sustainable materials", "status": "partial" },
      { "text": "Made in France", "status": "missing" }
    ],
    "attributeMetrics": {
      "aligned": 1,
      "partial": 1,
      "missing": 1,
      "total": 3
    },
    "insights": {
      "strengths": ["Strong brand recognition in core market"],
      "weaknesses": ["Limited awareness of product range"],
      "opportunities": ["Growing demand in adjacent category"],
      "threats": ["Aggressive competitor messaging"]
    },
    "providers": ["chatgpt", "perplexity"],
    "createdAt": "2026-05-01T03:00:00.000Z",
    "completedAt": "2026-05-03T04:12:00.000Z"
  }
}
```

Les tableaux SWOT sont des observations enregistrées, générées par un modèle. Considérez-les comme des éléments à examiner, pas comme des faits vérifiés ni des prévisions.

## Erreurs

| Statut | Code | Description |
| - | - | - |
| `401` | erreur de passerelle | Échec de l’authentification |
| `404` | `RESOURCE_NOT_FOUND` | Marque ou instantané terminé introuvable 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.