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 (questi differiscono dagli identificatori riconosciuti dal parametro select).
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#/...
Un elenco di brand separati da virgole da cercare. Almeno uno tra brand, competitors, market o where non deve essere vuoto.
Un elenco separato da virgole dei concorrenti dei tuoi brand.
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.
Un elenco di codici paese a due lettere (ISO 3166-1 alpha-2), separati da virgole.
Il tipo di prompt da utilizzare. Se non specificato, verranno utilizzati entrambi. I prompt personalizzati richiedono la specifica di un report_id.
Il numero di risultati da restituire.
La data da cercare nel formato YYYY-MM-DD.
Una data con cui confrontare date, nel formato YYYY-MM-DD. Deve essere rigorosamente precedente a date. Se impostata, il report include tutti i prompt a cui è stata data risposta in una delle due date e il campo status riporta come ciascuno è cambiato tra le due. Un prompt a cui è stata data risposta solo in date_compared viene indicato come lost e il resto dei suoi campi descrive la risposta di date_compared, poiché non ne ha una in date.
Una colonna in base alla quale ordinare i risultati.
Il formato di output.
Risposte
Ogni menzione di un brand tracciato nella risposta, prima i tuoi brand e poi i concorrenti nel loro ordine, con il modo in cui la risposta ne parla.
Il brand tracciato menzionato.
Il modo in cui la risposta parla del brand in questa menzione. Null quando non è disponibile.
Di cosa tratta la menzione, ad esempio prezzo o qualità. Null quando non è disponibile.
La frase che contiene la menzione. Null quando non è possibile trovarla nella risposta.
Il paese della domanda.
Il modello di chatbot che ha generato la risposta.
La fase del funnel del prompt. Null quando non è disponibile alcuna fase del funnel.
Le etichette di intento del prompt, tra cui l’intento principale, i sottotipi e gli attributi brandizzati/locali. Un array vuoto indica che non sono disponibili etichette di intento.
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".