Lister les signaux sociaux
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/social \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/social"
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}/social', 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
},
"social": [
{
"id": "<string>",
"platform": "<string>",
"communityId": "<string>",
"communityName": "<string>",
"url": "<string>",
"title": "<string>",
"domain": "<string>",
"position": 123,
"upvotes": 123,
"commentCount": 123,
"createdAt": "<string>"
}
]
}Signaux
Lister les signaux sociaux
Listez les citations classées comme sources de plateformes sociales dans les réponses enregistrées.
GET
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
social
Lister les signaux sociaux
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/social \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/social"
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}/social', 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
},
"social": [
{
"id": "<string>",
"platform": "<string>",
"communityId": "<string>",
"communityName": "<string>",
"url": "<string>",
"title": "<string>",
"domain": "<string>",
"position": 123,
"upvotes": 123,
"commentCount": 123,
"createdAt": "<string>"
}
]
}Renvoie les citations classées comme sources sociales ou de forums dans les réponses enregistrées. Les valeurs de filtre stables sont
reddit, youtube, twitter, facebook, linkedin et other.
string
requis
Jeton bearer. Exemple :
Bearer qw-api-xxxGET /api/v1/brands/{brandId}/social
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 plateforme :
reddit, youtube, twitter, facebook, linkedin, othernumber
défaut:"50"
Nombre maximal de citations renvoyées (maximum : 100)
number
défaut:"0"
Nombre de résultats à ignorer pour la pagination
string
défaut:"createdAt"
Champ de tri :
createdAt, position, upvotes, comments, urlstring
défaut:"desc"
Ordre de tri :
asc ou descRéponse
boolean
Indique si la requête a réussi
object
array
Afficher Objet citation sociale
Afficher Objet citation sociale
string
Identifiant de l’observation sociale
string
Nom de la plateforme (reddit, youtube, twitter, etc.)
string
Identifiant de la communauté (subreddit, chaîne, etc.)
string
Nom affiché de la communauté
string
URL complète du contenu cité
string
Titre du contenu (s’il est disponible)
string
Nom de domaine
number
Position dans la liste des sources
number
Votes positifs ou mentions j’aime (Reddit, si disponible)
number
Nombre de commentaires (si disponible)
string
Horodatage ISO 8601
Exemple de requête
curl -X GET "https://www.qwairy.co/api/v1/brands/cm1234567890abcdef/social?platform=reddit&limit=10" \
-H "Authorization: Bearer qw-api-your-token-here"
Exemple de réponse
{
"success": true,
"pagination": {
"total": 156,
"count": 2,
"limit": 10,
"offset": 0
},
"social": [
{
"id": "soc1",
"platform": "reddit",
"communityId": "SaaS",
"communityName": "r/SaaS",
"url": "https://reddit.com/r/SaaS/comments/abc123/best_crm_tools",
"title": "Analytics tools discussed by a sample community",
"domain": "reddit.com",
"position": 2,
"upvotes": 245,
"commentCount": 89,
"createdAt": "2026-07-15T10:30:00Z"
},
{
"id": "soc2",
"platform": "youtube",
"communityId": "TechReviewer",
"communityName": "TechReviewer",
"url": "https://youtube.com/@TechReviewer/crm-comparison",
"title": "Synthetic analytics comparison",
"domain": "youtube.com",
"position": 3,
"upvotes": 0,
"commentCount": 0,
"createdAt": "2026-07-14T15:45:00Z"
}
]
}
Les métadonnées d’engagement manquantes sont renvoyées à
0. N’interprétez pas 0 comme un engagement vérifié sur la plateforme sans consulter la source.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 |