Cited Pages

API + MCP

GET/v3/brand-radar/cited-pages

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

selectstringRequired

A comma-separated list of fields to return.

Available fields:

responses
url

wherestring

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

limitinteger

The number of results to return.

Default:1000

datestring (date)

The date to search for in YYYY-MM-DD format.

search_volume_typestring

AI visibility reports are switching to AI adjusted volume. It better estimates demand for AI responses across chatbots and AI search surfaces. It is calculated by adjusting Google search volume for each AI platform’s estimated usage compared with Google. This param will be deprecated on August 31, 2026; all requests will use new AI adjusted volume.

Allowed values:ask_volumekeyword_volume

Default:ask_volume

countrystring

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

Allowed values:adaeafagaialamaoarasatauawazba…

tracked_urlsstring

A comma-separated list of tracked page URLs. When provided, the response includes rows with zero citations for any tracked URLs that have no data.

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

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:jsonphp

Responses

pagesarray<object>

mentionsarray<object>

Deprecated on 2026-02-10.

responsesinteger

The number of responses that cited the page.

urlstring

The URL of the cited page.

volumeinteger

Deprecated on 2026-03-24.