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.
Corpo della richiesta
Richiede date_compared. Mantiene solo i prompt che sono cambiati in uno dei modi selezionati qui. Le tre colonne sono in OR tra loro, così come lo sono i valori all’interno di ciascuna colonna; quindi una colonna omessa o vuota non aggiunge nulla al filtro e un oggetto completamente vuoto mantiene ogni prompt.
Mantieni i prompt a cui è stata data risposta solo in una delle due date (new, lost) o in entrambe (no_change).
Mantieni i prompt in cui l’insieme dei tuoi brand menzionati nella risposta ha acquisito un brand (new), ne ha perso uno (lost) o è identico in entrambe le date (no_change). I competitor non vengono considerati.
Mantieni i prompt in cui l’insieme dei tuoi domini citati dalla risposta ha acquisito un dominio (new), ne ha perso uno (lost) o è identico in entrambe le date (no_change). I competitor non vengono considerati.
Una data con cui confrontare date, nel formato YYYY-MM-DD. Deve essere strettamente antecedente a date. Se impostata, il report include tutti i prompt a cui è stata data risposta in una delle due date e il campo status indica come ciascuno è cambiato tra le due date. Un prompt a cui è stata data risposta solo in date_compared viene segnalato come lost e il resto dei suoi campi descrive la risposta di date_compared, poiché in date non ce n’è alcuna.
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).
L’intervallo di volume da usare come filtro.
Un elenco di campi da restituire.
L’espressione di filtro. Sono riconosciuti i seguenti identificatori di colonna (diversi dagli identificatori riconosciuti dal parametro select).
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.
Il numero di risultati da restituire.
La data da cercare nel formato YYYY-MM-DD.
I report sulla visibilità dell’IA stanno passando al volume corretto per l’IA. Questo valore stima meglio la domanda di risposte dell’IA su chatbot e superfici di ricerca basate sull’IA. Viene calcolato correggendo il volume di ricerca di Google in base all’utilizzo stimato di ciascuna piattaforma di IA rispetto a Google. Questo parametro verrà deprecato il 30 settembre 2026; tutte le richieste useranno il nuovo volume corretto per l’IA.
Un elenco di codici paese a due lettere (ISO 3166-1 alpha-2).
Una colonna in base a cui ordinare i risultati.
L’ID del report da usare. Se specificato, gli altri parametri vengono presi dal report (brand, competitor, mercato, paese, filtri). Se vengono forniti paese o filtri, sovrascrivono quelli del report. Puoi trovarlo nell’URL del tuo report di 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. 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 dei mercati di nicchia dei tuoi brand. Deprecato il 2026-05-18, questo parametro non avrà alcun effetto poco dopo questa data.
Un elenco di nomi e siti web dei concorrenti da cercare.
names or url_groups is requiredI nomi del brand/concorrente
Il dominio del target
Ambito del target.
Un elenco di nomi e siti web dei brand da cercare.
names or url_groups is requiredI nomi del brand/concorrente
Il dominio del target
Ambito del target.
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.
Come il prompt è cambiato tra date_compared e date. Null, a meno che non sia impostato date_compared. new — risposta presente in date ma non in date_compared. lost — risposta presente in date_compared ma non in date; il resto di questa riga descrive la risposta di date_compared, poiché in date non ce n’è alcuna. no_change — risposta presente in entrambe le date, il che non dice nulla sul fatto che la risposta in sé, le sue menzioni o le sue citazioni siano cambiate.
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".