Historia przeglądu – Wyświetlenia

API + MCP

GET/v3/brand-radar/impressions-history

Żą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).

date_tostring (date)

Data końcowa okresu historycznego w formacie YYYY-MM-DD.

date_fromstring (date)Wymagane

Data początkowa okresu historycznego w formacie YYYY-MM-DD.

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 zostaną pobrane z raportu (market, country, filters). Jeśli podano country lub filters, zastępują one wartości 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.

brandstringWymagane

Marka do wyszukania.

outputstring

Format wyjściowy.

Dozwolone wartości:jsoncsvxmlphp

Odpowiedzi

metricsarray<object>

datestring (date)

impressionsinteger

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