Overview - Impressions

API + MCP

GET/v3/brand-radar/impressions-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).

selectstringRequired

A comma-separated list of fields to return.

countrystring

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

Allowed values:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

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#/...

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

data_sourcestringRequired

A comma-separated list of chatbot models. Google keyword models (google_ai_overviews_keywords, google_ai_mode_keywords) cannot be combined with each other or with other models.

Allowed values:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

marketstring

A comma-separated list of the niche markets of your brands. Deprecated on 2026-05-18, this parameter will have no effect shortly after this date.

competitorsstring

A comma-separated list of competitors of your brands.

brandstring

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

outputstring

The output format.

Allowed values:jsoncsvxmlphp

Responses

metricsarray<object>

brandstring

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

no_tracked_brandsinteger

Estimated impressions from responses related to the specified market that do not mention any provided brands (value is zero when market is not specified).

only_competitors_brandsinteger

Estimated impressions from responses mentioning only competitor brands.

only_target_brandinteger

Estimated impressions from responses mentioning only your brand.

target_and_competitors_brandsinteger

Estimated impressions from responses mentioning both your and competitor brands.

totalinteger

Total estimated impressions for your brand (includes both only_target_brand and target_and_competitors_brands).