Impressioni
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 da restituire separati da virgole.
L’espressione di filtro. Sono riconosciuti i seguenti identificatori di colonna (diversi 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.
I report sulla visibilità IA stanno passando al volume rettificato per l’IA. Offre una stima migliore della domanda di risposte IA su chatbot e superfici di ricerca IA. Viene calcolato rettificando il volume di ricerca Google in base all’utilizzo stimato di ciascuna piattaforma IA rispetto a Google. Questo parametro verrà deprecato il 30 settembre 2026; tutte le richieste utilizzeranno il nuovo volume rettificato per l’IA.
Il formato di output.
Risposte
Nome del brand (il tuo brand o un concorrente fornito nella richiesta).
Impression stimate provenienti da risposte relative al mercato specificato che non menzionano alcun brand fornito (il valore è zero quando market non è specificato).
Impression stimate provenienti da risposte che menzionano solo i brand dei concorrenti.
Impression stimate provenienti da risposte che menzionano solo il tuo brand.
Impression stimate provenienti da risposte che menzionano sia il tuo brand sia i brand dei concorrenti.
Totale impression stimate per il tuo brand (include sia only_target_brand sia target_and_competitors_brands).