Skip to main content
GET
Social Signals
Track citations from social platforms (Reddit, YouTube, Twitter, forums) in AI responses. Understand which social content AI platforms reference when answering questions about your industry.

List Social Insights

string
required
Bearer token. Example: Bearer qw-api-xxx

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 (ISO 8601 format)
string
End date (ISO 8601 format)
string
Filter by AI provider. Supports comma-separated multi-select (e.g., chatgpt,claude).
string
Filter by platform: reddit, youtube, twitter, facebook, linkedin, other
number
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, url
string
default:"desc"
Sort order: asc or desc

Response

boolean
Indicates if the request was successful
object
array

Example Request

Example Response

Social signals like upvotes and comments are only available for platforms that expose this data (primarily Reddit). Other platforms may show 0 for these fields.

Error Responses