Lister les commerces locaux
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/local \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/local"
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}/local', 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
},
"local": [
{
"id": "<string>",
"businessName": "<string>",
"category": "<string>",
"address": "<string>",
"websiteUrl": "<string>",
"position": 123,
"rating": 123,
"reviewCount": 123,
"prompt": "<string>",
"createdAt": "<string>"
}
]
}Signaux
Lister les commerces locaux
Listez les observations d’commerces locaux extraites des réponses enregistrées.
GET
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
local
Lister les commerces locaux
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/local \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/local"
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}/local', 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
},
"local": [
{
"id": "<string>",
"businessName": "<string>",
"category": "<string>",
"address": "<string>",
"websiteUrl": "<string>",
"position": 123,
"rating": 123,
"reviewCount": 123,
"prompt": "<string>",
"createdAt": "<string>"
}
]
}Renvoie les observations d’commerces locaux extraites des réponses enregistrées. Chaque enregistrement est une observation, pas une recommandation vérifiée ni une fiche d’établissement à jour.
string
requis
Jeton bearer. Exemple :
Bearer qw-api-xxxGET /api/v1/brands/{brandId}/local
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 catégorie d’établissement (correspondance partielle, sans tenir compte de la casse)
number
défaut:"50"
Nombre maximal d’établissements 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, reviewCount, position, businessNamestring
défaut:"desc"
Ordre de tri :
asc ou descRéponse
boolean
Indique si la requête a réussi
object
array
Afficher Objet commerce local
Afficher Objet commerce local
string
Identifiant de l’observation locale
string
Nom de l’établissement
string
Catégorie de l’établissement
string
Adresse de l’établissement
string
URL du site de l’établissement
number
Position dans la liste (1 = premier résultat)
number
Note de l’établissement (0 à 5)
number
Nombre d’avis
string
Prompt associé à l’observation enregistrée
string
Horodatage ISO 8601
Exemple de requête
curl -X GET "https://www.qwairy.co/api/v1/brands/cm1234567890abcdef/local?category=restaurant&limit=10" \
-H "Authorization: Bearer qw-api-your-token-here"
Exemple de réponse
{
"success": true,
"pagination": {
"total": 42,
"count": 2,
"limit": 10,
"offset": 0
},
"local": [
{
"id": "loc1",
"businessName": "Northstar Café",
"category": "Café",
"address": "10 Example Street, Paris",
"websiteUrl": "https://cafe.northstar.example",
"position": 1,
"rating": 4.8,
"reviewCount": 2500,
"prompt": "Which cafés are mentioned near the example district?",
"createdAt": "2026-07-15T10:30:00Z"
},
{
"id": "loc2",
"businessName": "Orbit Bistro",
"category": "Restaurant",
"address": "20 Example Avenue, Paris",
"websiteUrl": "https://bistro.orbit.example",
"position": 2,
"rating": 4.5,
"reviewCount": 1800,
"prompt": "Which cafés are mentioned near the example district?",
"createdAt": "2026-07-15T10:30: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 |