---
title: "Each tracked brand's mentions as a share of every tracked brand's"
method: GET
path: "/share-of-voice"
---

# Each tracked brand's mentions as a share of every tracked brand's

`GET /share-of-voice`

## Request

- Base URL: `https://app.aimentiontracker.ai/api/v1`
- URL: `https://app.aimentiontracker.ai/api/v1/share-of-voice`
- Auth: API key in header `X-API-Key`

THE ONE PLACE THIS API COMBINES A COMPETITOR'S NUMBER WITH YOURS. Everywhere else engines are reported separately and nothing is averaged; share of voice is a ratio by definition, so the honest move is to publish the denominator beside it rather than refuse the metric.

THE DENOMINATOR IS THE BRANDS YOU TRACK, NOT THE MARKET. A workspace tracking two competitors and one tracking twelve produce incomparable numbers from identical answers, so always report brands_counted alongside.

## Query parameters

- `days` integer
- `brand` string

## Response `200`

OK

- object
  - `data` ShareOfVoice[], required
    - `brand` string, required: The brand this row describes.
    - `is_you` boolean, required: True for the workspace's own brand.
    - `mentions` integer, required: Answers in the window that named this brand.
    - `share` number, nullable, required: This brand's mentions over every tracked brand's, to 4dp. NULL when no brand was named at all, because a share of an empty pool is undefined. That is not the same as a 0% share.
  - `meta` object, required
    - `generated_at` string, date-time
    - `brand` BrandRef: Which brand a response describes. Present in meta on every data endpoint.
      - `id` string, required: Pass as ?brand=.
      - `name` string, required: Display name.
    - `note` string
    - `window_days` integer
    - `total_mentions` integer: The denominator. Sum of every tracked brand's mentions.
    - `brands_counted` integer: How many brands went into the denominator.

## Other responses

- `400`: brand_required, or a cursor that does not belong to this brand.
- `401`: Missing, malformed, revoked or expired key.
- `402`: The organisation has never subscribed, or the plan excludes the API.
- `403`: The key lacks the required scope.
- `404`: No such brand, or the brand has not finished setup.
- `429`: Rate limit exceeded. Carries Retry-After.

---

[API](https://skmtc.dev/aimentiontracker/apis/aimentiontracker-api.md) · [All operations](https://skmtc.dev/aimentiontracker/apis/aimentiontracker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aimentiontracker/apis/aimentiontracker-api/revisions/c3329178c84c?raw)