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.
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.
string
required
Bearer token. Example:
Bearer qw-api-xxxGET /api/v1/brands/{brandId}/social
Path parameters
string
required
The unique identifier of the brand
Query parameters
number
Number of days to include. If not specified, returns all data.
string
Start date in
YYYY-MM-DD. Provide it with endDate; a lone boundary is currently ignored. Choose either period or the complete date pair.string
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.string
Filter by one or more provider aliases or model IDs, separated by commas.
string
Filter by platform:
reddit, youtube, twitter, facebook, linkedin, othernumber
default:"50"
Maximum number of citations to return (max: 100)
number
default:"0"
Number of results to skip for pagination
string
default:"createdAt"
Field to sort by:
createdAt, position, upvotes, comments, urlstring
default:"desc"
Sort order:
asc or descResponse
boolean
Indicates if the request was successful
object
array
Show Social citation object
Show Social citation object
string
Social insight ID
string
Platform name (reddit, youtube, twitter, etc.)
string
Community identifier (subreddit, channel, etc.)
string
Community display name
string
Full URL of the cited content
string
Content title (if available)
string
Domain name
number
Position in source list
number
Upvotes/likes (Reddit, when available)
number
Comment count (when available)
string
ISO 8601 timestamp
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 |