Storico panoramica - Share of Voice

API + MCP

GET/v3/brand-radar/sov-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 usare. Se ne viene specificato uno, gli altri parametri vengono ricavati dal report (brand, concorrenti, mercato, paese, filtri). Se vengono forniti paese o filtri, questi 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. 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.

competitorsstring

Un elenco separato da virgole dei concorrenti dei tuoi brand.

brandstring

Un elenco separato da virgole dei brand da cercare. Almeno uno dei parametri brand, competitors, market o where non deve essere vuoto.

outputstring

Il formato di output.

Valori consentiti:jsonphp

Risposte

metricsarray<object>

datestring (date)

share_of_voicearray<object>

(1 unità per brand) Quota di voce stimata per il brand.

brandstring

share_of_voicenumber (float)