Each tracked brand's mentions as a share of every tracked brand's
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.
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
Query parameters
Which brand to report on, from GET /brands. REQUIRED when the organisation has more than one: omitting it returns 400 brand_required rather than defaulting, because a silent default files one customer's numbers under another's. Ignored by a key pinned to a single brand, which refuses any other.
Response
OK
Changes
No recorded changes to this operation across all 1 revision of this API.