Temso Docs
API referenceBrands

List Brand Mentions

Returns one row per brand mention extracted from AI responses in the date range, with position, sentiment, and perception attributes. Covers your own brand and tracked competitors; use filter[brandIds] to narrow to specific brands.

GET
/projects/{projectId}/brands/mentions

Returns one row per brand mention extracted from AI responses in the date range, with position, sentiment, and perception attributes. Covers your own brand and tracked competitors; use filter[brandIds] to narrow to specific brands.

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/brands/mentions?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": [
    {
      "responseId": "string",
      "brandId": "string",
      "brandName": "string",
      "isOwnBrand": true,
      "model": "openai/chatgpt",
      "position": 0,
      "sentiment": "string",
      "perception": [
        "string"
      ],
      "createdAt": "string"
    }
  ],
  "pagination": {
    "page": 0,
    "limit": 0,
    "total": 0
  }
}

List Suggested Competitors GET

Returns competitor brands Temso has surfaced but that haven't been accepted into tracking yet. Accept them in the app to include them in analytics.

List Sources GET

Returns one row per source citation from AI responses in the date range — the URLs models referenced when answering. Use it to analyze which domains and pages drive AI answers in your space.