> ## 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 domaine source

> Récupérez le détail d’une source, avec ventilations par fournisseur et par Topic.

Renvoie un domaine cité avec ses indicateurs sur la période, ses ventilations par fournisseur et par Topic, et son dernier score public d’autorité de la source.

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

## Exemple de requête

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

<ParamField path="sourceId" type="string" required>
  L’identifiant unique de la source
</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>

## Exemple de réponse

```json theme={null}
{
  "success": true,
  "source": {
    "id": "source_01",
    "domain": "publisher.example",
    "type": "MEDIA",
    "status": "ACTIVE",
    "isSelf": false,
    "totalMentions": 102,
    "rate": 5.10,
    "avgPosition": 3.2,
    "aiSourceAuthorityScore": 61,
    "byProvider": [
      { "provider": "ChatGPT", "mentions": 60, "avgPosition": 3.1 },
      { "provider": "Perplexity", "mentions": 42, "avgPosition": 3.4 }
    ],
    "byTopic": [
      { "topic": "Product Reviews", "mentions": 55, "avgPosition": 2.8 },
      { "topic": "Comparisons", "mentions": 30, "avgPosition": 3.5 }
    ]
  }
}
```

`rate` correspond aux occurrences de citation de ce domaine divisées par toutes les occurrences de citation de la période sélectionnée. `aiSourceAuthorityScore` peut valoir `null` indépendamment de ce filtre de dates, car il provient du dernier instantané d’autorité.

## Erreurs

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