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 da restituire, separati da virgola. Campi disponibili: domain, responses, volume, pages, mentions.

wherestring

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

cited_domain: Il dominio di una pagina utilizzata per generare la risposta.
type: domain

cited_domain_subdomains: Il dominio di una pagina utilizzata per generare la risposta. Verrà considerato corrispondente anche qualsiasi sottodominio del dominio specificato.
type: string

cited_url_exact: L’URL di una pagina utilizzata per generare la risposta.
type: string

cited_url_prefix: L’URL di una pagina utilizzata per generare la risposta. Verrà considerato corrispondente qualsiasi URL che inizia con questo prefisso.
type: string

question: La domanda posta dall’utente.
type: string

response (10 unità): La risposta del modello.
type: string

search_queries: La query di ricerca utilizzata dal chatbot per trovare informazioni per la risposta. Nota: se data_source non include chatgpt o perplexity, questo campo sarà sempre vuoto.
type: string

topic: L’argomento della query.
type: string

limitinteger

Il numero di risultati da restituire.

Predefinita:1000

datestring (date)

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

countrystring

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

Valori consentiti:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

report_idstring

L'ID del report da usare. Se ne viene indicato uno, gli altri parametri vengono presi dal report (brand, concorrenti, mercato, paese, filtri). Se vengono forniti il paese o i filtri, sovrascrivono quelli del report. Puoi trovarlo nell'URL del report di Brand Radar in Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

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

data_sourcestringObbligatorio

Un elenco di modelli di chatbot separati da virgole. I modelli di keyword di Google (google_ai_overviews_keywords, google_ai_mode_keywords) non possono essere combinati tra loro né con altri modelli.

Valori consentiti:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

marketstring

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

competitorsstring

Un elenco, separato da virgole, dei concorrenti dei tuoi brand.

brandstring

Un elenco, separato da virgole, dei brand da cercare. Almeno uno tra brand, competitors, market o where non deve essere vuoto.

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.