Verlaufsübersicht – Share of Voice

API + MCP

GET/v3/brand-radar/sov-history

Anfragen an diesen Endpoint verbrauchen API-Einheiten basierend auf dem Parameter prompts: Anfragen, die ausschließlich Daten zu einem eigenen Prompt zurückgeben, sind kostenlos, während Anfragen mit Ahrefs-Prompt-Daten der Standard-Preisgestaltung für API-Einheiten folgen.

Query-Parameter

wherestring

Der Filterausdruck. Die folgenden Spaltenkennungen werden erkannt (sie unterscheiden sich von den Kennungen, die vom Parameter select erkannt werden).

report_idstring

Das Enddatum des historischen Zeitraums im Format YYYY-MM-DD.

brandstring

Das Startdatum des historischen Zeitraums im Format YYYY-MM-DD.

competitorsstring

KI-Sichtbarkeits-Reports wechseln zu KI-angepasstem Volumen. Es schätzt die Nachfrage nach KI-Antworten über Chatbots und KI-Suchflächen hinweg besser. Es wird berechnet, indem das Google-Suchvolumen anhand der geschätzten Nutzung jeder KI-Plattform im Vergleich zu Google angepasst wird. Dieser Parameter wird am 30. September 2026 eingestellt; alle Anfragen verwenden dann das neue KI-angepasste Volumen.

data_sourcestringErforderlich

Eine durch Kommas getrennte Liste zweibuchstabiger Ländercodes (ISO 3166-1 alpha-2).

Zulässige Werte:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

countrystring

Die ID des zu verwendenden Reports. Wenn eine angegeben ist, werden die anderen Parameter aus dem Report übernommen (Marke, Wettbewerber, Markt, Land, Filter). Wenn Land oder Filter angegeben sind, überschreiben sie die Angaben im Report. Sie finden sie in der URL Ihres Brand-Radar-Reports in Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

Zulässige Werte:adaeafagaialamaoarasatauawazba…

promptsstring

Der Typ der zu verwendenden Prompts. Falls nicht angegeben, werden beide verwendet. Eigene Prompts erfordern die Angabe von report_id.

Zulässige Werte:ahrefscustom

date_fromstring (date)Erforderlich

Eine durch Kommas getrennte Liste von Chatbot-Modellen. Alle Modelle lassen sich miteinander kombinieren. Das claude-Modul unterstützt nur eigene Prompts.
Die Modelle google_ai_overviews_keywords und google_ai_mode_keywords melden die aus Google-Suchanfragen (Keywords) statt aus Prompts abgeleitete Sichtbarkeit in AI Overviews / im KI-Modus.

date_tostring (date)

Eine durch Kommas getrennte Liste der Nischenmärkte Ihrer Marken. Am 2026-05-18 als veraltet markiert; dieser Parameter wird kurz nach diesem Datum keine Wirkung mehr haben.

search_volume_typestring

Eine durch Kommas getrennte Liste von Wettbewerbern Ihrer Marken.

Zulässige Werte:ask_volumekeyword_volume

Standard:ask_volume

outputstring

Das Ausgabeformat.

Zulässige Werte:jsonphp

Antworten

metricsarray<object>

datestring (date)

share_of_voicearray<object>

(1 Einheit pro Marke) Geschätzter Share of Voice für die Marke.

brandstring

share_of_voicenumber (float)