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 da restituire, separati da virgole.

Campi disponibili:
  • responses
  • title
  • url
wherestring

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

report_idstring

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

brandstring

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

competitorsstring

Un elenco separato da virgole dei concorrenti dei tuoi brand.

data_sourcestringObbligatorio

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à in AI Overview / modalità IA ricavata dalle query di ricerca Google (parole chiave), anziché dai prompt.

Valori consentiti:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
Example:chatgpt,perplexity
countrystring

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

Valori consentiti:adaeafagaialamaoarasatauawazba…
promptsstring

Il tipo di prompt da utilizzare. Se non specificato, verranno utilizzati entrambi. I prompt personalizzati richiedono la specifica di un report_id.

Valori consentiti:ahrefscustom
limitinteger

Il numero di risultati da restituire.

Predefinita:1000
datestring (date)

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

tracked_urlsstring

Un elenco di URL delle pagine monitorate, separato da virgole. Se specificato, la risposta include righe con zero citazioni per tutti gli URL monitorati per cui non sono disponibili dati.

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.

titlestring or null

Il titolo della pagina come mostrato nella citazione della risposta dell’IA, oppure il titolo della pagina sottoposta a crawling quando nessuna risposta ne ha registrato uno. null se non è noto nessuno dei due.

urlstring

L’URL della pagina citata.

volumeinteger

Deprecato il 2026-03-24.