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 Spaltenbezeichner werden erkannt (sie unterscheiden sich von den Bezeichnern, die vom Parameter select erkannt werden).

date_tostring (date)

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

date_fromstring (date)Erforderlich

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

search_volume_typestring

Reports zur KI-Sichtbarkeit stellen auf KI-angepasstes Suchvolumen um. Damit lässt sich die Nachfrage nach KI-Antworten über Chatbots und KI-Suchoberflächen hinweg besser abschätzen. Es wird berechnet, indem das Google-Suchvolumen anhand der geschätzten Nutzung jeder KI-Plattform im Vergleich zu Google angepasst wird. Dieser Parameter wird ab dem 31. August 2026 nicht mehr unterstützt; alle Anfragen verwenden dann das neue KI-angepasste Suchvolumen.

Zulässige Werte:ask_volumekeyword_volume

Standard:ask_volume

countrystring

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

Zulässige Werte:adaeafagaialamaoarasatauawazba…

report_idstring

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 werden, überschreiben sie die entsprechenden Angaben im Report. Du findest die ID in der URL deines Brand Radar-Reports in Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

promptsstring

Die Art der zu verwendenden Prompts. Wenn nichts angegeben ist, werden beide verwendet. Für eigene Prompts muss report_id angegeben sein.

Zulässige Werte:ahrefscustom

data_sourcestringErforderlich

Eine kommagetrennte Liste von Chatbot-Modellen. Alle Modelle können miteinander kombiniert werden. Das claude-Modul unterstützt nur eigene Prompts.
Die Modelle google_ai_overviews_keywords und google_ai_mode_keywords geben die Sichtbarkeit in AI Overviews / im AI Mode an, die aus Google-Suchanfragen (Keywords) statt aus Prompts abgeleitet wird.

Zulässige Werte:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

marketstring

Eine kommagetrennte Liste der Nischenmärkte Ihrer Marken. Dieser Parameter gilt ab dem 18.05.2026 als veraltet und wird kurz nach diesem Datum keine Wirkung mehr haben.

competitorsstring

Eine durch Kommas getrennte Liste der Wettbewerber Ihrer Marken.

brandstring

Eine durch Kommas getrennte Liste der Marken, nach denen gesucht werden soll. Mindestens einer der Parameter „brand“, „competitors“, „market“ oder „where“ darf nicht leer sein.

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)