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

> Récupérez le détail d’une marque précise.

Récupère une marque accessible avec le nombre actuel de prompts non supprimés, de réponses non supprimées et de domaines concurrents SELF ou DIRECT.

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

## Réponse

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

<ResponseField name="brand" type="object">
  <Expandable title="Détail de la marque">
    <ResponseField name="id" type="string">
      Identifiant opaque de la marque
    </ResponseField>

    <ResponseField name="name" type="string">
      Nom affiché de la marque
    </ResponseField>

    <ResponseField name="domain" type="string">
      Domaine principal de la marque
    </ResponseField>

    <ResponseField name="description" type="string">
      Description de la marque (peut être null)
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      Horodatage de création ISO 8601
    </ResponseField>

    <ResponseField name="stats" type="object">
      <Expandable title="Statistiques de la marque">
        <ResponseField name="promptsCount" type="number">
          Nombre de prompts suivis pour cette marque
        </ResponseField>

        <ResponseField name="answersCount" type="number">
          Nombre de réponses enregistrées non supprimées
        </ResponseField>

        <ResponseField name="competitorsCount" type="number">
          Nombre de concurrents (SELF + DIRECT)
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

## Exemple de requête

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

## Exemple de réponse

```json theme={null}
{
  "success": true,
  "brand": {
    "id": "brand_01",
    "name": "Acme Analytics",
    "domain": "acme.example",
    "description": "Analytics software for operations teams.",
    "createdAt": "2026-07-15T10:30:00.000Z",
    "stats": {
      "promptsCount": 156,
      "answersCount": 312,
      "competitorsCount": 8
    }
  }
}
```

## Erreurs

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