Odsłony

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

report_idstring

ID raportu, którego należy użyć. Jeśli zostanie podany, pozostałe parametry zostaną pobrane z raportu (kraj, filtry). Jeśli podasz kraj lub filtry, zastąpią one wartości z raportu. Znajdziesz go w adresie URL raportu Brand Radar w Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

brandstringWymagane

Marka do wyszukania.

data_sourcestringWymagane

Lista modeli chatbotów rozdzielona przecinkami. 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ść AI Overview / AI Mode 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

countrystring

Rozdzielana przecinkami lista dwuliterowych kodów krajów (ISO 3166-1 alpha-2).

Dozwolone wartości:adaeafagaialamaoarasatauawazba…

promptsstring

Typ promptów do użycia. Jeśli nie określono, użyte zostaną oba. Niestandardowe prompty wymagają podania report_id.

Dozwolone wartości:ahrefscustom

date_fromstring (date)Wymagane

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

date_tostring (date)

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

search_volume_typestring

Raporty widoczności AI przechodzą na wolumen skorygowany o AI. Lepiej szacuje popyt na odpowiedzi AI w chatbotach i w obszarach 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 skorygowanego o AI.

Dozwolone wartości:ask_volumekeyword_volume

Domyślne:ask_volume

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ę.