Temso

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)

Range1 <= value
Default1
limit?integer

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

Range1 <= value <= 1000
Default50

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  }}