> ## 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 domaines sources

> Suivez les domaines cités par les plateformes IA.

Liste les domaines cités et leur part d’occurrences de citation dans le périmètre de réponses sélectionné.

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

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

## Paramètres de requête

<ParamField query="period" type="number">
  Nombre de jours à inclure. Sans valeur, toutes les données sont renvoyées.
</ParamField>

<ParamField query="startDate" type="string">
  Date de début au format `YYYY-MM-DD`. Fournissez-la avec `endDate` ; une borne seule est actuellement ignorée. Choisissez soit `period`, soit la paire de dates complète.
</ParamField>

<ParamField query="endDate" type="string">
  Date de fin au format `YYYY-MM-DD`. Fournissez-la avec `startDate` ; une borne seule est actuellement ignorée. Ne combinez pas la paire de dates complète avec `period`.
</ParamField>

<ParamField query="provider" type="string">
  Filtre par fournisseur IA. Accepte plusieurs valeurs séparées par des virgules (par exemple `chatgpt,claude`).
</ParamField>

<ParamField query="type" type="string">
  Filtre par type de source : `INSTITUTIONAL`, `COMMERCIAL`, `MEDIA`, `BLOG`, etc.
</ParamField>

<ParamField query="topic" type="string">
  Filtre par identifiant de Topic. 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="limit" type="number" default="50">
  Nombre maximal de sources renvoyées (maximum : 100)
</ParamField>

<ParamField query="offset" type="number" default="0">
  Nombre de résultats à ignorer pour la pagination
</ParamField>

<ParamField query="sort" type="string" default="mentions">
  Champ de tri : `mentions`, `position`, `rate`, `domain`
</ParamField>

<ParamField query="order" type="string" default="desc">
  Ordre de tri : `asc` ou `desc`
</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 sources correspondant aux filtres</ResponseField>
    <ResponseField name="count" type="number">Nombre de sources 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>
  </Expandable>
</ResponseField>

<ResponseField name="sources" type="array">
  <Expandable title="Objet Source">
    <ResponseField name="id" type="string">Identifiant de la source</ResponseField>
    <ResponseField name="domain" type="string">Nom de domaine</ResponseField>
    <ResponseField name="type" type="string">Type de source</ResponseField>
    <ResponseField name="isSelf" type="boolean">Indique s’il s’agit de votre propre domaine</ResponseField>
    <ResponseField name="totalMentions" type="number">Nombre total de citations</ResponseField>
    <ResponseField name="rate" type="number">Occurrences de citation de ce domaine divisées par toutes les occurrences de citation du périmètre sélectionné</ResponseField>
    <ResponseField name="avgPosition" type="number">Position moyenne dans les listes de sources</ResponseField>
    <ResponseField name="aiSourceAuthorityScore" type="number | null">Dernier score public d’autorité de la source, ou `null` si les données sont insuffisantes ou si aucun instantané n’existe</ResponseField>
  </Expandable>
</ResponseField>

## Exemple de requête

```bash theme={null}
curl "https://www.qwairy.co/api/v1/brands/YOUR_BRAND_ID/source-domains?limit=10&offset=0" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN"
```

## Exemple de réponse

```json theme={null}
{
  "success": true,
  "pagination": {
    "total": 45,
    "count": 2,
    "limit": 10,
    "offset": 0
  },
  "sources": [
    {
      "id": "source_01",
      "domain": "publisher.example",
      "type": "MEDIA",
      "isSelf": false,
      "totalMentions": 102,
      "rate": 5.10,
      "avgPosition": 3.2,
      "aiSourceAuthorityScore": 61
    },
    {
      "id": "source_02",
      "domain": "acme.example",
      "type": "INSTITUTIONAL",
      "isSelf": true,
      "totalMentions": 45,
      "rate": 2.25,
      "avgPosition": 2.1,
      "aiSourceAuthorityScore": null
    }
  ]
}
```

## Erreurs

| Statut | Signification |
| - | - |
| `400` | Paramètre de requête invalide |
| `401` | Jeton d’API manquant ou invalide |
| `404` | Marque introuvable ou inaccessible |
| `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.