Historia przeglądu – Wzmianki

API + MCP

GET/v3/brand-radar/mentions-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).

cited_domain: Domena strony użytej do wygenerowania odpowiedzi.
typ: domain

cited_domain_subdomains: Domena strony użytej do wygenerowania odpowiedzi. Dopasowane będą również dowolne subdomeny podanej domeny.
typ: string

cited_url_exact: URL strony użytej do wygenerowania odpowiedzi.
typ: string

cited_url_prefix: URL strony użytej do wygenerowania odpowiedzi. Dopasowany będzie dowolny adres URL zaczynający się od tego prefiksu.
typ: string

question: Pytanie zadane przez użytkownika.
typ: string

response (10 jednostek): Odpowiedź z modelu.
typ: string

search_queries: Zapytanie wyszukiwania użyte przez chatbota do znalezienia informacji na potrzeby odpowiedzi. Uwaga: jeśli data_source nie zawiera chatgpt ani perplexity, to pole będzie zawsze puste.
typ: string

topic: Temat zapytania.
typ: string

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.

countrystring

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

Dozwolone wartości:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

report_idstring

Identyfikator raportu, którego należy użyć. Jeśli zostanie podany, pozostałe parametry są pobierane z raportu (market, country, filters). Jeśli zostaną podane country lub filters, zastąpią 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 określony, użyte zostaną oba. Niestandardowe prompty wymagają podania report_id.

Dozwolone wartości:ahrefscustom

data_sourcestringWymagane

Lista modeli chatbotów rozdzielonych przecinkami. Modele słów kluczowych Google (google_ai_overviews_keywords, google_ai_mode_keywords) nie mogą być łączone ze sobą ani z innymi modelami.

Dozwolone wartości:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

marketstring

Lista rynków niszowych Twoich marek rozdzielona przecinkami. Wycofane od 2026-05-18; krótko po tej dacie ten parametr przestanie działać.

brandstringWymagane

Marka do wyszukania.

outputstring

Format wyjściowy.

Dozwolone wartości:jsoncsvxmlphp

Odpowiedzi

metricsarray<object>

datestring (date)

mentionsinteger

Szacowana liczba wzmianek na podstawie odpowiedzi, w których wspomniano markę.