Domini citati

API + MCP

GET/v3/brand-radar/cited-domains

Le richieste a questo endpoint consumano unità API in base al parametro prompts: le richieste che restituiscono solo i dati dei prompt personalizzati sono gratuite, mentre le richieste che includono i dati dei prompt Ahrefs seguono il prezzo standard delle unità API.

Parametri della query

selectstringObbligatorio

Un elenco di campi separati da virgole da restituire.

Campi disponibili:

domain
pages
responses

wherestring

L’espressione di filtro. Sono riconosciuti i seguenti identificatori di colonna (diversi dagli identificatori riconosciuti dal parametro select).

report_idstring

Il numero di risultati da restituire.

brandstring

La data da cercare nel formato YYYY-MM-DD.

competitorsstring

I report sulla visibilità dell’IA stanno passando al volume corretto per l’IA. Questo valore stima meglio la domanda di risposte dell’IA su chatbot e superfici di ricerca basate sull’IA. Viene calcolato correggendo il volume di ricerca di Google in base all’utilizzo stimato di ciascuna piattaforma di IA rispetto a Google. Questo parametro verrà deprecato il 30 settembre 2026; tutte le richieste useranno il nuovo volume corretto per l’IA.

data_sourcestringObbligatorio

Un elenco di codici paese a due lettere (ISO 3166-1 alpha-2), separati da virgole.

Valori consentiti:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

countrystring

L’ID del report da usare. Se specificato, gli altri parametri vengono presi dal report (brand, competitor, mercato, paese, filtri). Se vengono forniti paese o filtri, sovrascrivono quelli del report. Puoi trovarlo nell’URL del tuo report di Brand Radar in Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

Valori consentiti:adaeafagaialamaoarasatauawazba…

promptsstring

Il tipo di prompt da usare. Se non specificato, verranno usati entrambi. I prompt personalizzati richiedono che venga fornito un report_id.

Valori consentiti:ahrefscustom

limitinteger

Un elenco di modelli di chatbot, separati da virgole. Tutti i modelli possono essere combinati tra loro. Il modulo claude supporta solo i prompt personalizzati.
I modelli google_ai_overviews_keywords e google_ai_mode_keywords riportano la visibilità di AI Overviews / AI Mode derivata da query di ricerca Google (keyword) anziché dai prompt.

Predefinita:1000

datestring (date)

Un elenco di mercati di nicchia dei tuoi brand, separati da virgole. Deprecato il 2026-05-18, questo parametro non avrà effetto poco dopo questa data.

search_volume_typestring

Un elenco di competitor dei tuoi brand, separati da virgole.

Valori consentiti:ask_volumekeyword_volume

Predefinita:ask_volume

outputstring

Il formato di output.

Valori consentiti:jsonphp

Risposte

domainsarray<object>

domainstring

Il nome di dominio citato.

mentionsarray<object>

Deprecato il 2026-02-10.

pagesinteger

Il numero di pagine uniche del dominio che sono state citate nelle risposte.

responsesinteger

Il numero di risposte che hanno citato il dominio.

volumeinteger

Deprecato il 2026-03-24.