Share of Voice

API + MCP

GET/v3/brand-radar/sov-overview

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 (questi differiscono dagli identificatori riconosciuti dal parametro select).

report_idstring

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#/...

brandstring

Un elenco di brand separati da virgole da cercare. Almeno uno tra brand, competitors, market o where non deve essere vuoto.

competitorsstring

Un elenco separato da virgole dei concorrenti dei tuoi brand.

data_sourcestringObbligatorio

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.

Valori consentiti:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

countrystring

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

Valori consentiti:adaeafagaialamaoarasatauawazba…

promptsstring

Il tipo di prompt da utilizzare. Se non specificato, verranno utilizzati entrambi. I prompt personalizzati richiedono la specifica di un report_id.

Valori consentiti:ahrefscustom

outputstring

Il formato di output.

Valori consentiti:jsoncsvxmlphp

Risposte

metricsarray<object>

brandstring

Nome del brand (il tuo brand o un concorrente fornito nella richiesta).

entity_typestring

Indica se la riga rappresenta un aggregato, il tuo brand target o un concorrente.

Valori consentiti:aggregatetargetcompetitor

share_of_voicenumber (float)

Quota di voce stimata per il tuo brand.