Risposte AI
API + MCPLe 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
Un elenco di campi separati da virgole da restituire.
L’espressione di filtro. Sono riconosciuti i seguenti identificatori di colonna (diversi da quelli riconosciuti dal parametro select).
Il numero di risultati da restituire.
La data da cercare nel formato YYYY-MM-DD.
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.
Un elenco di codici paese a due lettere (ISO 3166-1 alpha-2) separati da virgole.
Colonna in base alla quale ordinare i risultati.
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#/...
Il tipo di prompt da usare. Se non specificato, verranno usati entrambi. I prompt personalizzati richiedono che venga fornito un report_id.
Un elenco di modelli di chatbot separati da virgole. 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.
Un elenco separato da virgole dei mercati di nicchia dei tuoi brand. Deprecato in data 2026-05-18, questo parametro non avrà più alcun effetto poco dopo tale data.
Un elenco separato da virgole dei concorrenti dei tuoi brand.
Un elenco separato da virgole dei brand da cercare. Almeno uno dei parametri brand, competitors, market o where non deve essere vuoto.
Il formato di output.
Risposte
Il paese della domanda.
Il modello di chatbot che ha generato la risposta.
La data dell’ultimo aggiornamento dei dati.
(10 unità) I link utilizzati per la risposta.
La domanda posta dall'utente.
(10 unità) La risposta del modello.
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.
Tag assegnati alla query.
(10 unità) Ricerche mensili stimate. Il dato si basa sulle nostre stime per Google, sommando il volume di ricerca delle parole chiave correlate in cui questa domanda compare nella sezione "People Also Ask".