Lister les domaines sources
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/source-domains \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/source-domains"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/source-domains', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"pagination": {
"total": 123,
"count": 123,
"limit": 123,
"offset": 123
},
"sources": [
{
"id": "<string>",
"domain": "<string>",
"type": "<string>",
"isSelf": true,
"totalMentions": 123,
"rate": 123,
"avgPosition": 123,
"aiSourceAuthorityScore": {}
}
]
}Sources
Lister les domaines sources
Suivez les domaines cités par les plateformes IA.
GET
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
source-domains
Lister les domaines sources
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/source-domains \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/source-domains"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/source-domains', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"pagination": {
"total": 123,
"count": 123,
"limit": 123,
"offset": 123
},
"sources": [
{
"id": "<string>",
"domain": "<string>",
"type": "<string>",
"isSelf": true,
"totalMentions": 123,
"rate": 123,
"avgPosition": 123,
"aiSourceAuthorityScore": {}
}
]
}Liste les domaines cités et leur part d’occurrences de citation dans le périmètre de réponses sélectionné.
Consultez Limites de débit pour la gestion des nouvelles tentatives.
Consultez Entités pour la structure complète de l’objet Source.
string
requis
Jeton bearer. Exemple :
Bearer qw-api-xxxParamètres de chemin
string
requis
L’identifiant unique de la marque
Paramètres de requête
number
Nombre de jours à inclure. Sans valeur, toutes les données sont renvoyées.
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.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.string
Filtre par fournisseur IA. Accepte plusieurs valeurs séparées par des virgules (par exemple
chatgpt,claude).string
Filtre par type de source :
INSTITUTIONAL, COMMERCIAL, MEDIA, BLOG, etc.string
Filtre par identifiant de Topic. Accepte plusieurs valeurs séparées par des virgules (par exemple
id1,id2).string
Filtre par identifiant de Tag. Accepte plusieurs valeurs séparées par des virgules (par exemple
id1,id2).number
défaut:"50"
Nombre maximal de sources renvoyées (maximum : 100)
number
défaut:"0"
Nombre de résultats à ignorer pour la pagination
string
défaut:"mentions"
Champ de tri :
mentions, position, rate, domainstring
défaut:"desc"
Ordre de tri :
asc ou descRéponse
boolean
Indique si la requête a réussi
object
array
Afficher Objet Source
Afficher Objet Source
string
Identifiant de la source
string
Nom de domaine
string
Type de source
boolean
Indique s’il s’agit de votre propre domaine
number
Nombre total de citations
number
Occurrences de citation de ce domaine divisées par toutes les occurrences de citation du périmètre sélectionné
number
Position moyenne dans les listes de sources
number | null
Dernier score public d’autorité de la source, ou
null si les données sont insuffisantes ou si aucun instantané n’existeExemple de requête
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
{
"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 |

