Storico panoramica - Impressioni

API + MCP

GET/v3/brand-radar/impressions-history

Le 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

wherestring

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

date_tostring (date)

La data di fine del periodo storico nel formato YYYY-MM-DD.

date_fromstring (date)Obbligatorio

La data di inizio del periodo storico nel formato YYYY-MM-DD.

countrystring

Un elenco di codici paese a due lettere (ISO 3166-1 alpha-2), separati da virgole.

Valori consentiti:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

report_idstring

L'ID del report da usare. Se ne viene specificato uno, gli altri parametri vengono presi dal report (mercato, paese, filtri). Se vengono forniti paese o filtri, sovrascrivono quelli del report. Puoi trovarlo nell'URL del tuo report Brand Radar in Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

promptsstring

Il tipo di prompt da usare. Se non specificato, verranno usati entrambi. I prompt personalizzati richiedono che venga fornito un report_id.

Valori consentiti:ahrefscustom

data_sourcestringObbligatorio

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.

Valori consentiti:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

marketstring

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.

brandstringObbligatorio

Il brand da cercare.

outputstring

Il formato di output.

Valori consentiti:jsoncsvxmlphp

Risposte

metricsarray<object>

datestring (date)

impressionsinteger

Impression stimate dalle risposte che menzionano il brand.