Get Brand Perception
Returns how each brand is described in AI responses — the share of mentions carrying each perception attribute (e.g. reliable, innovative) — for your own brand and competitors.
Returns how each brand is described in AI responses — the share of mentions carrying each perception attribute (e.g. reliable, innovative) — for your own brand and competitors.
Path Parameters
Project ID (see List Projects)
Query Parameters
Page number (1-indexed, default: 1)
1 <= value1Items per page (default: 50, max: 1000)
1 <= value <= 100050Response Body
application/json
curl -X GET "https://example.com/projects/string/analytics/brand-perception?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, "perceptions": [ { "attribute": "string", "share": 0 } ] } ], "pagination": { "page": 0, "limit": 0, "total": 0 }}Get Performance Breakdown GET
Returns your brand's visibility broken down by a dimension — language, country, offering, persona, or models — over the date range.
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.