Get Share of Voice

Compare your brand’s share of voice against competitors in AI search results.

GET /ai-analytics-service/api/public/v1/analytics/share-of-voice

Get Share of Voice

cURL

curl --request GET \
  --url https://api.slatehq.ai/ai-analytics-service/api/public/v1/analytics/share-of-voice \
  --header 'Authorization: <authorization>'

200

{
  "data": [
    {
      "brandMentions": 123,
      "position": 123,
      "visibility": 123,
      "entityName": "<string>",
      "entityType": "<string>",
      "shareOfVoice": 123,
      "date": "<string>"
    }
  ]
}

Returns share of voice data for your brand and competitors over a specified date range. Share of voice measures how often each brand is mentioned relative to all brands in AI responses.

Parameters

Authorization · string · required

Bearer token. Format: Bearer slat_<your-token>.

dateRange · integer · required

Number of days for the analysis window (e.g., 7, 30, 90).

topicId · number

Filter by topic ID.

platform · string[]

Filter by one or more platforms: CHATGPT, PERPLEXITY, GOOGLE_AI_OVERVIEW, GOOGLE_AI_MODE, GEMINI, CLAUDE.

Response

Returns 200 OK with an array of share of voice data for each entity.

data · object[] · required

Array of share of voice objects.

Show share of voice object

brandMentions · integer · required

Total mention count.

position · number · required

Average position in AI responses.

visibility · number · required

Visibility score.

entityName · string · required

Brand or competitor name.

entityType · string · required

One of: BRAND, COMPETITOR.

shareOfVoice · number · required

Share of voice percentage.

date · string · required

Date for the data point. Format: YYYY-MM-DD.

Example

cURL

curl -s "https://api.slatehq.ai/ai-analytics-service/api/public/v1/analytics/share-of-voice?dateRange=30&topicId=42" \
  -H "Authorization: Bearer slat_YOUR_TOKEN"

Response

[
  {
    "brandMentions": 42,
    "position": 2,
    "visibility": 85,
    "entityName": "MyBrand",
    "entityType": "BRAND",
    "shareOfVoice": 35.5,
    "date": "2026-02-11"
  },
  {
    "brandMentions": 30,
    "position": 3,
    "visibility": 70,
    "entityName": "CompetitorA",
    "entityType": "COMPETITOR",
    "shareOfVoice": 25.0,
    "date": "2026-02-11"
  }
]

Status codes

Status	Description
200	Share of voice data returned.
401	Missing or invalid Bearer token. See Authentication.
500	Internal server error.

What’s next

• Get Visibility Comparison — Ranked visibility comparison.
• Get Trends — View trends over time.