Docs
Szukaj w dokumentacji...⌘K

Cytowane domeny

API + MCP
GET/v3/brand-radar/cited-domains

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

selectstringWymagane

Lista pól zwracanych w odpowiedzi, rozdzielonych przecinkami.

Dostępne pola:
  • domain
  • pages
  • responses
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 podane, pozostałe parametry są pobierane z raportu (marka, konkurenci, rynek, kraj, filtry). Jeśli podano kraj lub filtry, zastępują one wartości z raportu. Znajdziesz je w adresie URL raportu Brand Radar w Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

brandstring

Rozdzielana przecinkami lista marek do wyszukania. Co najmniej jedno z pól brand, competitors, market lub where nie może być puste.

competitorsstring

Rozdzielana przecinkami lista konkurentów twoich marek.

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
limitinteger

Liczba wyników do zwrócenia.

Domyślne:1000
datestring (date)

Data, dla której ma zostać wykonane wyszukiwanie, 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:jsonphp

Odpowiedzi

domainsarray<object>
domainstring

Nazwa cytowanej domeny.

mentionsarray<object>

Oznaczone jako przestarzałe dnia 2026-02-10.

pagesinteger

Liczba unikalnych stron z tej domeny, które były cytowane w odpowiedziach.

responsesinteger

Liczba odpowiedzi, które cytowały tę domenę.

volumeinteger

Oznaczone jako przestarzałe dnia 2026-03-24.