Panoramica - 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
L’espressione di filtro. Sono riconosciuti i seguenti identificatori di colonna (diversi dagli identificatori riconosciuti dal parametro select).
cited_domain: Il dominio di una pagina utilizzata per generare la risposta.
type: domain
cited_domain_subdomains: Il dominio di una pagina utilizzata per generare la risposta. Verrà considerato corrispondente anche qualsiasi sottodominio del dominio specificato.
type: string
cited_url_exact: L’URL di una pagina utilizzata per generare la risposta.
type: string
cited_url_prefix: L’URL di una pagina utilizzata per generare la risposta. Verrà considerato corrispondente qualsiasi URL che inizia con questo prefisso.
type: string
question: La domanda posta dall’utente.
type: string
response (10 unità): La risposta del modello.
type: string
search_queries: 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.
type: string
topic: L’argomento della query.
type: string
Un elenco di campi, separati da virgole, da restituire. Campi disponibili: brand, only_target_brand, only_competitors_brands, target_and_competitors_brands, no_tracked_brands, total.
Un elenco di codici paese a due lettere (ISO 3166-1 alpha-2), separati da virgole.
L'ID del report da usare. Se ne viene indicato uno, gli altri parametri vengono presi dal report (brand, concorrenti, mercato, paese, filtri). Se vengono forniti il paese o i filtri, sovrascrivono quelli del report. Puoi trovarlo nell'URL del 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 separati da virgole. I modelli di keyword di Google (google_ai_overviews_keywords, google_ai_mode_keywords) non possono essere combinati tra loro né con altri modelli.
Un elenco separato da virgole dei mercati di nicchia dei tuoi brand. Deprecato il 2026-05-18, questo parametro non avrà alcun effetto poco dopo questa data.
Un elenco, separato da virgole, dei concorrenti dei tuoi brand.
Un elenco, separato da virgole, dei brand da cercare. Almeno uno tra brand, competitors, market o where non deve essere vuoto.
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).