Docs
Cerca nella documentazione...⌘K

Pagine citate

API + MCP
POST/v3/brand-radar/cited-pages

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

volume_rangeobject

L’intervallo di volume da usare come filtro.

frominteger
tointeger
selectarray<string>Required

Un elenco di campi da restituire.

Campi disponibili:
  • responses
  • url
Example:["field_a","field_b"]
whereobject

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

tags_filterobject

Un'espressione di filtro per i tag dei prompt. Richiede report_id. Utilizza 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 e or è 2. Esempio: {"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.

countryarray<string>

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

Allowed values:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
Default:
tracked_urlsarray<string>

Un elenco di URL di pagine tracciate. Se fornito, la risposta include righe con zero citazioni per qualsiasi URL tracciato per cui non ci sono dati.

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.

Allowed values:ahrefscustom
data_sourcearray<string>Required

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

Allowed values:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_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.

Allowed values: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.

Allowed values:urlpathdomainsubdomains
outputstring

Il formato di output.

Allowed values:jsonphp

Risposte

pagesarray<object>
mentionsarray<object>

Deprecato il 2026-02-10.

responsesinteger

Il numero di risposte che hanno citato la pagina.

urlstring

L’URL della pagina citata.

volumeinteger

Deprecato il 2026-03-24.