List social signals
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>"
}
]
}Signals
List social signals
List citations classified as social-platform sources in stored answers, filterable by reddit, youtube, twitter, facebook, linkedin, or other.
GET
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
social
List social signals
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>"
}
]
}Returns citations classified as social or forum sources in stored answers. The stable filter values are
reddit, youtube, twitter, facebook, linkedin, and other.
GET /api/v1/brands/{brandId}/social
Path parameters
Query parameters
Start date in
YYYY-MM-DD. Provide it with endDate; a lone boundary is currently ignored. Choose either period or the complete date pair.End date in
YYYY-MM-DD. Provide it with startDate; a lone boundary is currently ignored. Do not combine the complete date pair with period.Response
Show Social citation object
Show Social citation object
Synthetic request
curl -X GET "https://www.qwairy.co/api/v1/brands/cm1234567890abcdef/social?platform=reddit&limit=10" \
-H "Authorization: Bearer qw-api-your-token-here"
Synthetic response
{
"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"
}
]
}
Missing engagement metadata is returned as
0. Do not interpret 0 as a verified platform engagement count without checking the underlying source.Errors
| Status | Code | Description |
|---|---|---|
| 400 | INVALID_PARAMETER | Invalid filter, pagination, or sort value |
| 401 | gateway error | Authentication failed |
| 404 | BRAND_NOT_FOUND | Brand doesn’t exist or not accessible |
| 429 | gateway error | Rate limit exceeded; honor Retry-After |