Docs
Cerca nella documentazione...⌘K

Pagine citate

API + MCP
GET/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.

Parametri della query

selectstringObbligatorio

Un elenco di campi separati da virgole da restituire.

Campi disponibili:
  • responses
  • url
wherestring

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

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
tracked_urlsstring

Un elenco di URL di pagine tracciate separati da virgole. 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.

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

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.