Przegląd – Wyświetlenia

API + MCP

GET/v3/brand-radar/impressions-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 filtra. Rozpoznawane są następujące identyfikatory kolumn (różnią się od identyfikatorów rozpoznawanych przez parametr select).

selectstringWymagane

Lista pól zwracanych w odpowiedzi, rozdzielonych przecinkami.

search_volume_typestring

Raporty widoczności AI przechodzą na wolumen wyszukiwań skorygowany o AI. Lepiej szacuje popyt na odpowiedzi AI w chatbotach i systemach wyszukiwania AI. Jest obliczany przez skorygowanie wolumenu wyszukiwań Google o szacowane użycie każdej platformy AI w porównaniu z Google. Ten parametr zostanie wycofany 30 września 2026 r.; wszystkie żądania będą korzystać z nowego wolumenu wyszukiwań skorygowanego o AI.

Dozwolone wartości:ask_volumekeyword_volume

Domyślne:ask_volume

countrystring

Rozdzielana przecinkami lista dwuliterowych kodów krajów (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 (brand, competitors, market, country, filters). Jeśli podano country lub filters, zastąpią 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 do użycia. Jeśli nie zostanie określony, użyte zostaną oba. Niestandardowe prompty wymagają podania report_id.

Dozwolone wartości:ahrefscustom

data_sourcestringWymagane

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

Dozwolone wartości:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

marketstring

Rozdzielana przecinkami lista rynków niszowych Twoich marek. Ten parametr został wycofany 2026-05-18; wkrótce po tej dacie nie będzie miał żadnego wpływu.

competitorsstring

Rozdzielana przecinkami lista konkurentów Twoich marek.

brandstring

Rozdzielana przecinkami lista marek do wyszukania. Co najmniej jedno z pól brand, competitors, market lub where musi być niepuste.

outputstring

Format wyjściowy.

Dozwolone wartości:jsoncsvxmlphp

Odpowiedzi

metricsarray<object>

brandstring

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

no_tracked_brandsinteger

Szacowana liczba wyświetleń na podstawie odpowiedzi związanych z określonym rynkiem, w których nie wspomniano żadnej z podanych marek (wartość wynosi zero, gdy market nie jest określony).

only_competitors_brandsinteger

Szacowana liczba wyświetleń na podstawie odpowiedzi, w których wspomniano wyłącznie marki konkurencji.

only_target_brandinteger

Szacowana liczba wyświetleń na podstawie odpowiedzi, w których wspomniano wyłącznie Twoją markę.

target_and_competitors_brandsinteger

Szacowana liczba wyświetleń na podstawie odpowiedzi, w których wspomniano zarówno Twoją markę, jak i marki konkurencji.

totalinteger

Łączna szacowana liczba wyświetleń dla Twojej marki (obejmuje zarówno only_target_brand, jak i target_and_competitors_brands).