Obtenir un domaine source
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/source-domains/{sourceId} \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/source-domains/{sourceId}"
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/{sourceId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Sources
Obtenir un domaine source
Récupérez le détail d’une source, avec ventilations par fournisseur et par Topic.
GET
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
source-domains
/
{sourceId}
Obtenir un domaine source
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/source-domains/{sourceId} \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/source-domains/{sourceId}"
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/{sourceId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));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.
Consultez Limites de débit pour la gestion des nouvelles tentatives.
string
requis
Jeton bearer. Exemple :
Bearer qw-api-xxxParamètres de chemin
string
requis
L’identifiant unique de la marque
Exemple de requête
curl "https://www.qwairy.co/api/v1/brands/YOUR_BRAND_ID/source-domains/SOURCE_ID?period=30" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN"
string
requis
L’identifiant unique de la source
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.Exemple de réponse
{
"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 |