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 da quelli riconosciuti dal parametro select).

date_tostring (date)

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

date_fromstring (date)Obbligatorio

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

search_volume_typestring

I report sulla visibilità nell’IA stanno passando al volume rettificato per l’IA. Questo valore stima meglio la domanda di risposte dell’IA nei chatbot e nelle superfici di ricerca basate sull’IA. Viene calcolato rettificando il volume di ricerca di Google in base all’utilizzo stimato di ciascuna piattaforma di IA rispetto a Google. Questo parametro verrà deprecato il 31 agosto 2026; tutte le richieste useranno il nuovo volume rettificato per l’IA.

Valori consentiti:ask_volumekeyword_volume

Predefinita:ask_volume

countrystring

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

Valori consentiti:adaeafagaialamaoarasatauawazba…

report_idstring

L’ID del report da utilizzare. Se specificato, gli altri parametri vengono presi dal report (market, country, filters). Se vengono forniti country o filters, sovrascrivono quelli presenti nel report. Puoi trovarlo nell’URL del report di 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. 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.

Valori consentiti:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

marketstring

Un elenco separato da virgole dei mercati di nicchia dei tuoi brand. Deprecato in data 2026-05-18, questo parametro non avrà più alcun effetto poco dopo tale 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.