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

> Récupérez toutes les marques accessibles à votre équipe.

Renvoie les marques `LIVE` de l’équipe authentifiée dont le statut de transfert est `NONE`, triées par nom.

<Note>
  Consultez [Entités](/fr/developers/entities#brand) pour la structure complète de l’objet Brand.
</Note>

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

## Réponse

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

<ResponseField name="total" type="number">
  Nombre total de marques
</ResponseField>

<ResponseField name="brands" type="array">
  <Expandable title="Objet Brand">
    <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>
  </Expandable>
</ResponseField>

## Exemple de requête

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

## Exemple de réponse

```json theme={null}
{
  "success": true,
  "total": 2,
  "brands": [
    {
      "id": "brand_01",
      "name": "Acme Analytics",
      "domain": "acme.example"
    },
    {
      "id": "brand_02",
      "name": "Northstar Data",
      "domain": "northstar.example"
    }
  ]
}
```

## Étapes suivantes

Une fois les identifiants de vos marques obtenus, vous pouvez :

* [Obtenir les indicateurs de performance](/fr/developers/endpoints/performance)
* [Lister les concurrents](/fr/developers/endpoints/competitors/list)
* [Voir les domaines sources](/fr/developers/endpoints/source-domains/list)
* [Voir les URL sources](/fr/developers/endpoints/source-urls)
* [Parcourir les prompts](/fr/developers/endpoints/prompts/list)

## Erreurs

| Statut | Signification |
| - | - |
| `401` | Jeton d’API manquant ou invalide |
| `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.