API referenceAnalytics
Get Sentiment
Returns the sentiment distribution (positive / neutral / negative) of mentions for your own brand and competitors over the date range.
Returns the sentiment distribution (positive / neutral / negative) of mentions for your own brand and competitors over the date range.
Path Parameters
projectId*string
Project ID (see List Projects)
Query Parameters
filter*
page?integer
Page number (1-indexed, default: 1)
Range
1 <= valueDefault
1limit?integer
Items per page (default: 50, max: 1000)
Range
1 <= value <= 1000Default
50Response Body
application/json
curl -X GET "https://example.com/projects/string/analytics/sentiment?filter%5BstartDate%5D=2026-01-01&filter%5BendDate%5D=2026-03-19&filter%5Blanguages%5D=en%2Cde&filter%5Bcountries%5D=US%2CDE&filter%5Bmodels%5D=microsoft%2Fcopilot-search%2Cgoogle%2Fai-overview%2Cgoogle%2Fai-mode%2Cperplexity%2Fsearch%2Cgemini%2Fsearch%2Copenai%2Fchatgpt&filter%5BpromptTypes%5D=informational%2Cnavigational&filter%5BisBranded%5D=true&filter%5BpersonaIds%5D=string&filter%5BofferingIds%5D=string&filter%5BpromptTagIds%5D=string&filter%5BbrandIds%5D=string"{ "data": [ { "brandId": "string", "brandName": "string", "isOwnBrand": true, "totalMentions": 0, "sentiments": [ { "sentiment": "string", "count": 0, "share": 0 } ] } ], "pagination": { "page": 0, "limit": 0, "total": 0 }}Get Perception Sources GET
Returns the source URLs backing a specific perception attribute for your own brand — the citations that contributed to how your brand is perceived.
Get Sentiment Sources GET
Returns the source URLs backing a specific sentiment for your own brand — the citations behind positive, neutral, or negative mentions.