Share of Voice

API + MCP

GET/v3/brand-radar/sov-overview

Requests to this endpoint consume API units based on the prompts parameter: requests returning only custom prompt data are free, while requests including Ahrefs prompt data follow standard API unit pricing.

Query parameters

wherestring

The filter expression. The following column identifiers are recognized (this differs from the identifiers recognized by the select parameter).

report_idstring

The ID of the report to use. If one is given, other parameters are taken from the report (brand, competitors, market, country, filters). If country or filters are provided, they override the ones in the report. You can find it in the URL of your Brand Radar report in Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

brandstring

A comma-separated list of brands to search for. At least one of brand, competitors, market or where should not be empty.

competitorsstring

A comma-separated list of competitors of your brands.

data_sourcestringRequired

A comma-separated list of chatbot models. All models can be combined with each other. claude module supports only custom prompts.
The google_ai_overviews_keywords and google_ai_mode_keywords models report AI Overviews / AI Mode visibility derived from Google search queries (keywords) rather than prompts.

Allowed values:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

countrystring

A comma-separated list of two-letter country codes (ISO 3166-1 alpha-2).

Allowed values:adaeafagaialamaoarasatauawazba…

promptsstring

The type of prompts to use. If not specified, both will be used. Custom prompts require a report_id to be provided.

Allowed values:ahrefscustom

outputstring

The output format.

Allowed values:jsoncsvxmlphp

Responses

metricsarray<object>

brandstring

Brand name (either your brand or a competitor provided in the request).

entity_typestring

Whether the row represents an aggregate, your target brand, or a competitor.

Allowed values:aggregatetargetcompetitor

share_of_voicenumber (float)

Estimated share of voice for your brand.