Lister les résultats shopping
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/shopping \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/shopping"
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}/shopping', 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
},
"shopping": [
{
"id": "<string>",
"productName": "<string>",
"description": "<string>",
"image": "<string>",
"rating": 123,
"reviews": 123,
"options": [
{}
],
"prompt": "<string>",
"createdAt": "<string>"
}
]
}Signaux
Lister les résultats shopping
Listez les observations shopping extraites des réponses enregistrées.
GET
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
shopping
Lister les résultats shopping
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/shopping \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/shopping"
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}/shopping', 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
},
"shopping": [
{
"id": "<string>",
"productName": "<string>",
"description": "<string>",
"image": "<string>",
"rating": 123,
"reviews": 123,
"options": [
{}
],
"prompt": "<string>",
"createdAt": "<string>"
}
]
}Renvoie les observations shopping extraites des réponses enregistrées. Le détail des produits, les notes, les avis et les options d’achat peuvent valoir
null ou être vides lorsqu’ils n’ont pas été capturés.
string
requis
Jeton bearer. Exemple :
Bearer qw-api-xxxGET /api/v1/brands/{brandId}/shopping
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.
number
défaut:"50"
Nombre maximal de produits renvoyés (maximum : 100)
number
défaut:"0"
Nombre de résultats à ignorer pour la pagination
string
défaut:"createdAt"
Champ de tri :
createdAt, rating, reviews, productNamestring
défaut:"desc"
Ordre de tri :
asc ou descRéponse
boolean
Indique si la requête a réussi
object
array
Afficher Objet shopping
Afficher Objet shopping
Exemple de requête
curl -X GET "https://www.qwairy.co/api/v1/brands/cm1234567890abcdef/shopping?limit=10" \
-H "Authorization: Bearer qw-api-your-token-here"
Exemple de réponse
{
"success": true,
"pagination": {
"total": 85,
"count": 2,
"limit": 10,
"offset": 0
},
"shopping": [
{
"id": "shop1",
"productName": "Northstar Analytics Pro",
"description": "Synthetic product description",
"image": "https://assets.northstar.example/product-image.jpg",
"rating": 4.5,
"reviews": 1250,
"options": [
{
"price": "$99/month",
"currency": "USD",
"websiteName": "Northstar Labs",
"websiteUrl": "https://northstar.example/pricing"
}
],
"prompt": "What is the best CRM software for enterprise?",
"createdAt": "2026-07-15T10:30:00Z"
},
{
"id": "shop2",
"productName": "Orbit Insights",
"description": "Synthetic analytics product",
"image": null,
"rating": 4.2,
"reviews": 890,
"options": [],
"prompt": "Compare top analytics platforms",
"createdAt": "2026-07-14T15:45: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 |