Obtenir un instantané de perception
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/perception/{snapshotId} \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/perception/{snapshotId}"
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}/perception/{snapshotId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"brand": {},
"snapshot": {
"snapshotId": "<string>",
"month": 123,
"year": 123,
"scores": {},
"attributes": [
{}
],
"attributeMetrics": {},
"insights": {},
"providers": [
{}
],
"createdAt": "<string>",
"completedAt": "<string>"
}
}Perception
Obtenir un instantané de perception
Récupérez un instantané de perception terminé, avec scores, alignement des attributs et observations SWOT.
GET
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
perception
/
{snapshotId}
Obtenir un instantané de perception
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/perception/{snapshotId} \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/perception/{snapshotId}"
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}/perception/{snapshotId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"brand": {},
"snapshot": {
"snapshotId": "<string>",
"month": 123,
"year": 123,
"scores": {},
"attributes": [
{}
],
"attributeMetrics": {},
"insights": {},
"providers": [
{}
],
"createdAt": "<string>",
"completedAt": "<string>"
}
}Renvoie un instantané de perception terminé. Récupérez
Un
Les tableaux SWOT sont des observations enregistrées, générées par un modèle. Considérez-les comme des éléments à examiner, pas comme des faits vérifiés ni des prévisions.
snapshotId dans le tableau history renvoyé par Lister les instantanés de perception.
string
requis
Jeton bearer. Exemple :
Bearer qw-api-xxxParamètres de chemin
string
requis
L’identifiant unique de la marque
string
requis
L’identifiant unique de l’instantané de perception
Réponse
boolean
Indique si la requête a réussi
object
id, name, domainobject
Afficher Instantané
Afficher Instantané
string
Identifiant de l’instantané
number
Mois (1 à 12)
number
Année
object
sentiment, alignment, consistency, factualAlignment (0 à 100 ou null)array
Attributs de la marque évalués par l’IA. Chaque objet a un
text (string) et un status (aligned, partial, missing).object
Nombres :
aligned, partial, missing, total.object
Tableaux SWOT de chaînes :
strengths, weaknesses, opportunities, threats.array
Fournisseurs IA inclus dans l’analyse
string
Horodatage de création (ISO 8601)
string
Horodatage de fin (ISO 8601) ou
null404 RESOURCE_NOT_FOUND est renvoyé si l’instantané n’existe pas, n’est pas COMPLETED ou n’appartient pas à la marque.
Exemple de requête
curl -X GET "https://www.qwairy.co/api/v1/brands/cm1234567890abcdef/perception/snap_2026_05" \
-H "Authorization: Bearer qw-api-your-token-here"
Exemple de réponse
{
"success": true,
"brand": {
"id": "cm1234567890abcdef",
"name": "Northstar Labs",
"domain": "northstar.example"
},
"snapshot": {
"snapshotId": "snap_2026_05",
"month": 5,
"year": 2026,
"scores": {
"sentiment": 78,
"alignment": 65,
"consistency": 82,
"factualAlignment": 71
},
"attributes": [
{ "text": "Premium positioning", "status": "aligned" },
{ "text": "Sustainable materials", "status": "partial" },
{ "text": "Made in France", "status": "missing" }
],
"attributeMetrics": {
"aligned": 1,
"partial": 1,
"missing": 1,
"total": 3
},
"insights": {
"strengths": ["Strong brand recognition in core market"],
"weaknesses": ["Limited awareness of product range"],
"opportunities": ["Growing demand in adjacent category"],
"threats": ["Aggressive competitor messaging"]
},
"providers": ["chatgpt", "perplexity"],
"createdAt": "2026-05-01T03:00:00.000Z",
"completedAt": "2026-05-03T04:12:00.000Z"
}
}
Erreurs
| Statut | Code | Description |
|---|---|---|
401 | erreur de passerelle | Échec de l’authentification |
404 | RESOURCE_NOT_FOUND | Marque ou instantané terminé introuvable ou inaccessible |
429 | erreur de passerelle | Limite de débit dépassée ; respectez Retry-After |