Temso Docs
API referenceAnalytics

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.

GET
/projects/{projectId}/analytics/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.

Path Parameters

projectId*string

Project ID (see List Projects)

Query Parameters

filter*
page?integer

Page number (1-indexed, default: 1)

Default1
Range1 <= value
limit?integer

Items per page (default: 50, max: 1000)

Default50
Range1 <= value <= 1000

Response 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.