Przegląd – Share of Voice

API + MCP

GET/v3/brand-radar/sov-overview

Żądania do tego punktu końcowego zużywają jednostki API w zależności od parametru prompts: żądania zwracające wyłącznie dane niestandardowego promptu są bezpłatne, natomiast żądania uwzględniające dane promptów Ahrefs są rozliczane zgodnie ze standardowym cennikiem jednostek API.

Parametry zapytania

wherestring

Wyrażenie filtrujące. Obsługiwane są następujące identyfikatory kolumn (różnią się one od identyfikatorów obsługiwanych przez parametr select).

search_volume_typestring

Raporty widoczności w AI przechodzą na wolumen skorygowany pod kątem AI. Lepiej szacuje on popyt na odpowiedzi AI w chatbotach i wyszukiwarkach AI. Jest obliczany przez skorygowanie wolumenu wyszukiwań Google o szacowane wykorzystanie każdej platformy AI w porównaniu z Google. Ten parametr zostanie wycofany 31 sierpnia 2026 r.; wszystkie żądania będą korzystać z nowego wolumenu skorygowanego pod kątem AI.

Dozwolone wartości:ask_volumekeyword_volume

Domyślne:ask_volume

countrystring

Lista dwuliterowych kodów krajów oddzielonych przecinkami (ISO 3166-1 alpha-2).

Dozwolone wartości:adaeafagaialamaoarasatauawazba…

report_idstring

Identyfikator raportu, którego należy użyć. Jeśli zostanie podany, pozostałe parametry są pobierane z raportu (marka, konkurenci, rynek, kraj, filtry). Jeśli podano kraj lub filtry, zastępują one te z raportu. Znajdziesz go w adresie URL raportu Brand Radar w Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

promptsstring

Typ promptów, których należy użyć. Jeśli nie zostanie podany, użyte zostaną oba typy. Niestandardowe prompty wymagają podania report_id.

Dozwolone wartości:ahrefscustom

data_sourcestringWymagane

Rozdzielona przecinkami lista modeli chatbotów. Wszystkie modele można łączyć ze sobą. Moduł claude obsługuje wyłącznie niestandardowe prompty.
Modele google_ai_overviews_keywords i google_ai_mode_keywords raportują widoczność w AI Overviews / AI Mode określoną na podstawie zapytań w wyszukiwarce Google (słów kluczowych), a nie promptów.

Dozwolone wartości:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

marketstring

Lista oddzielonych przecinkami rynków niszowych Twoich marek. Ten parametr został wycofany 2026-05-18 i wkrótce po tej dacie przestanie mieć jakikolwiek wpływ.

competitorsstring

Lista oddzielonych przecinkami konkurentów Twoich marek.

brandstring

Lista oddzielonych przecinkami marek do wyszukania. Co najmniej jeden z parametrów brand, competitors, market lub where nie powinien być pusty.

outputstring

Format wyjściowy.

Dozwolone wartości:jsoncsvxmlphp

Odpowiedzi

metricsarray<object>

brandstring

Nazwa marki (Twojej lub konkurenta podanego w żądaniu).

share_of_voicenumber (float)

Szacowany udział głosu Twojej marki.