Domini citati

API + MCP

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

Corpo della richiesta

brand_filterobject

Un’espressione di filtro per la visibilità del tuo brand, che rispecchia il filtro «Il tuo brand». brand_name verifica se una risposta menziona il tuo brand: "mentioned" o "not_mentioned". page_status verifica in che modo l’IA ha usato le tue pagine: "cited" (l’IA ha recuperato pagine dal tuo sito e le ha citate nella risposta), "found_but_not_cited" (l’IA ha recuperato pagine dal tuo sito come potenziali fonti, ma non le ha citate nella risposta finale) o "not_found" (l’IA non ha recuperato alcuna pagina dal tuo sito).
Usa la sintassi dei filtri con le seguenti restrizioni: l’unico operatore valido è "eq"; ogni campo è una sezione: specifica un singolo valore oppure combina più valori dello stesso campo con or; unisci le sezioni brand_name e page_status con un and/or di primo livello. La selezione di tutti i valori di un campo viene rifiutata, poiché corrisponde a tutto (in tal caso ometti il campo).

Example:{"and":[{"field":"brand_name","is":["eq","mentioned"]},{"or":[{"field":"page_status","is":["eq","cited"]},{"field":"page_status","is":["eq","found_but_not_cited"]}]}]}

volume_rangeobject

L’intervallo di volume da usare come filtro.

frominteger

tointeger

selectarray<string>Required

Un elenco di campi da restituire.

Campi disponibili:

domain
pages
responses

Example:["field_a","field_b"]

whereobject

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

tags_filterobject

Un’espressione di filtro per i tag dei prompt. Richiede report_id. Usa la sintassi dei filtri con le seguenti restrizioni: l’unico nome di campo valido è "tag"; gli unici operatori validi sono: "eq", "neq", "substring", "isubstring", "phrase_match", "iphrase_match", "prefix", "suffix", "empty"; la profondità massima di annidamento di and, or è 2.

Example:{"or":[{"field":"tag","is":["eq","branded"]},{"field":"tag","is":["eq","competitor"]}]}

limitinteger

Il numero di risultati da restituire.

Default:1000

datestring (date)

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

search_volume_typestring

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

Valori consentiti:ask_volumekeyword_volume

Default:ask_volume

countryarray<string>

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

Valori consentiti:adaeafagaialamaoarasatauawazba…

Default:[]

report_idstring

L’ID del report da usare. Se ne viene specificato uno, gli altri parametri vengono ricavati dal report (brand, concorrenti, mercato, paese, filtri). Se vengono forniti paese o filtri, questi sovrascrivono quelli del report. Puoi trovarlo nell’URL del tuo report 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_sourcearray<string>Required

Un elenco di modelli di chatbot. Tutti i modelli possono essere combinati tra loro. Il modulo claude supporta solo prompt personalizzati.
I modelli google_ai_overviews_keywords e google_ai_mode_keywords riportano la visibilità in AI Overviews / AI Mode calcolata a partire dalle query di ricerca su Google (parole chiave), anziché dai prompt.

Valori consentiti:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

marketarray<string>

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

competitorsarray<object>

Un elenco di nomi e siti web dei concorrenti da cercare.

Default:[]

At least one of names or url_groups is required

namesarray<string>

I nomi del brand/concorrente

Example:["ahrefs","ahrefs seo"]

url_groupsarray<object>

targetstring (domain)required

Il dominio del target

Example:ahrefs.com

scopestringrequired

Ambito del target.

Valori consentiti:urlpathdomainsubdomains

brandsarray<object>

Un elenco di nomi e siti web dei brand da cercare.

Default:[]

At least one of names or url_groups is required

namesarray<string>

I nomi del brand/concorrente

Example:["ahrefs","ahrefs seo"]

url_groupsarray<object>

targetstring (domain)required

Il dominio del target

Example:ahrefs.com

scopestringrequired

Ambito del target.

Valori consentiti:urlpathdomainsubdomains

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.

curl "https://api.ahrefs.com/v3/brand-radar/cited-domains" \ -X POST \ -H "Authorization: Bearer $AHREFS_API_KEY" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ --data-raw '{ "brand_filter": {"and":[{"field":"brand_name","is":["eq","mentioned"]},{"or":[{"field":"page_status","is":["eq","cited"]},{"field":"page_status","is":["eq","found_but_not_cited"]}]}]}, "volume_range": { "from": 0, "to": 0 }, "select": ["field_a","field_b"], "where": {}, "tags_filter": {"or":[{"field":"tag","is":["eq","branded"]},{"field":"tag","is":["eq","competitor"]}]}, "limit": 0, "date": "string", "search_volume_type": "ask_volume", "country": ["ad"], "report_id": "string", "prompts": "ahrefs", "data_source": ["chatgpt"], "market": ["string"], "competitors": [ { "names": ["ahrefs","ahrefs seo"], "url_groups": [ { "target": "ahrefs.com", "scope": "url" } ] } ], "brands": [ { "names": ["ahrefs","ahrefs seo"], "url_groups": [ { "target": "ahrefs.com", "scope": "url" } ] } ], "output": "json" }'