Temso Docs
API referenceAnalytics

Get Share of Voice

Returns daily mention counts per brand over the date range — one row per brand per day. Divide a brand's mentions by the day's total to compute its share of voice.

GET
/projects/{projectId}/analytics/share-of-voice

Returns daily mention counts per brand over the date range — one row per brand per day. Divide a brand's mentions by the day's total to compute its share of voice.

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/share-of-voice?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": [
    {
      "date": "2026-01-15",
      "brandName": "string",
      "isOwnBrand": true,
      "mentions": 0
    }
  ],
  "pagination": {
    "page": 0,
    "limit": 0,
    "total": 0
  }
}

Get Visibility GET

Returns your brand's daily visibility score over the date range, with the underlying response and mention counts. Use it to chart visibility trends or detect drops.

Get Brand Rankings GET

Returns aggregated per-brand performance over the date range: visibility, presence, share of voice, and mention/response counts for your own brand and competitors. This is the data behind the brand ranking view in the app.