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 del filtro. Sono riconosciuti i seguenti identificatori di colonna (che differiscono dagli identificatori riconosciuti dal parametro select).

cited_domain: Il dominio di una pagina utilizzata per generare la risposta.
tipo: dominio

cited_domain_subdomains: Il dominio di una pagina utilizzata per generare la risposta. Verrà considerata valida anche qualsiasi sottodominio del dominio indicato.
tipo: stringa

cited_url_exact: L'URL di una pagina utilizzata per generare la risposta.
tipo: stringa

cited_url_prefix: L'URL di una pagina utilizzata per generare la risposta. Verrà considerato valido qualsiasi URL che inizi con questo prefisso.
tipo: stringa

question: La domanda posta dall'utente.
tipo: stringa

response (10 unità): La risposta del modello.
tipo: stringa

search_queries: La query di ricerca usata dal chatbot per trovare informazioni per la risposta. Nota: se data_source non include chatgpt o perplexity, questo campo sarà sempre vuoto.
tipo: stringa

topic: L'argomento della query.
tipo: stringa

date_tostring

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

date_fromstringObbligatorio

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

countrystring

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

Valori consentiti:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

report_idstring

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

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 Google (google_ai_overviews, google_ai_mode) non possono essere combinati tra loro né con modelli non Google.

Valori consentiti:google_ai_overviewsgoogle_ai_modechatgptgeminiperplexitycopilotgrok

Example:chatgpt,perplexity

marketstring

Un elenco, separato da virgole, dei mercati di nicchia dei tuoi brand.

competitorsstring

Un elenco, separato da virgole, dei concorrenti dei tuoi brand.

brandstring

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

outputstring

Il formato di output.

Valori consentiti:jsonphp

Risposte

metricsarray<object>

datestring

share_of_voicearray<object>

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