Lister les contenus sponsorisés
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/sponsored \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/sponsored"
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}/sponsored', 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
},
"sponsored": [
{
"id": "<string>",
"advertiserName": "<string>",
"advertiserLogo": "<string>",
"productName": "<string>",
"description": "<string>",
"imageUrl": "<string>",
"position": 123,
"provider": "<string>",
"competitorRelationship": "<string>",
"prompt": "<string>",
"createdAt": "<string>"
}
]
}Signaux
Lister les contenus sponsorisés
Listez les emplacements sponsorisés détectés dans les réponses enregistrées.
GET
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
sponsored
Lister les contenus sponsorisés
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/sponsored \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/sponsored"
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}/sponsored', 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
},
"sponsored": [
{
"id": "<string>",
"advertiserName": "<string>",
"advertiserLogo": "<string>",
"productName": "<string>",
"description": "<string>",
"imageUrl": "<string>",
"position": 123,
"provider": "<string>",
"competitorRelationship": "<string>",
"prompt": "<string>",
"createdAt": "<string>"
}
]
}Renvoie les emplacements sponsorisés conservés à partir des réponses enregistrées. Un enregistrement reflète la réponse capturée à ce moment-là ; il ne confirme ni une campagne active ni une relation avec l’annonceur.
string
requis
Jeton bearer. Exemple :
Bearer qw-api-xxxGET /api/v1/brands/{brandId}/sponsored
Paramè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 un ou plusieurs alias de fournisseurs ou identifiants de modèles, séparés par des virgules.
string
Filtre par nom d’annonceur (correspondance partielle, sans tenir compte de la casse)
number
défaut:"50"
Nombre maximal de résultats renvoyés (maximum : 100)
number
défaut:"0"
Nombre de résultats à ignorer pour la pagination
string
défaut:"createdAt"
Champ de tri :
createdAt, advertiserName, productName, positionstring
défaut:"desc"
Ordre de tri :
asc ou descRéponse
boolean
Indique si la requête a réussi
object
array
Afficher Objet contenu sponsorisé
Afficher Objet contenu sponsorisé
string
Identifiant de l’enregistrement sponsorisé
string
Nom de l’annonceur
string
URL du logo de l’annonceur
string
Nom du produit mis en avant
string
Texte de description du produit
string
URL de l’image du produit
number
Position de la publicité dans la réponse (1 = première)
string
Identifiant du modèle du fournisseur IA
string
Relation avec votre marque si l’annonceur est un concurrent connu :
SELF, DIRECT, INDIRECT ou nullstring
Prompt associé à l’emplacement enregistré
string
Horodatage ISO 8601
Exemple de requête
curl -X GET "https://www.qwairy.co/api/v1/brands/cm1234567890abcdef/sponsored?period=30&limit=10" \
-H "Authorization: Bearer qw-api-your-token-here"
Exemple de réponse
{
"success": true,
"pagination": {
"total": 24,
"count": 2,
"limit": 10,
"offset": 0
},
"sponsored": [
{
"id": "sp1",
"advertiserName": "Orbit Travel",
"advertiserLogo": "https://assets.orbit.example/logo.png",
"productName": "Sample flight offer",
"description": "Synthetic sponsored placement description.",
"imageUrl": null,
"position": 1,
"provider": "openai-chatgpt-core",
"competitorRelationship": "DIRECT",
"prompt": "What are the best flight deals from Chicago?",
"createdAt": "2026-04-10T14:30:00Z"
},
{
"id": "sp2",
"advertiserName": "Northstar Retail",
"advertiserLogo": "https://assets.northstar.example/logo.png",
"productName": "Sample seasonal offer",
"description": "Synthetic sponsored placement description.",
"imageUrl": null,
"position": 1,
"provider": "google-ai-mode-core",
"competitorRelationship": null,
"prompt": "Best spring fashion deals 2026",
"createdAt": "2026-04-09T09:15:00Z"
}
]
}
Erreurs
| Statut | Code | Description |
|---|---|---|
| 400 | INVALID_PARAMETER | Valeur de filtre, de pagination ou de tri invalide |
| 401 | erreur de passerelle | Échec de l’authentification |
| 404 | BRAND_NOT_FOUND | Marque inexistante ou inaccessible |
| 429 | erreur de passerelle | Limite de débit dépassée ; respectez Retry-After |