Docs
Szukaj w dokumentacji...⌘K

Cytowane strony

API + MCP
POST/v3/brand-radar/cited-pages

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

Treść żądania

volume_rangeobject

Zakres wolumenu do filtrowania.

frominteger
tointeger
selectarray<string>Required

Lista pól zwracanych w odpowiedzi.

Dostępne pola:
  • responses
  • url
Example:["field_a","field_b"]
whereobject

Wyrażenie filtra. Rozpoznawane są następujące identyfikatory kolumn (różnią się one od identyfikatorów rozpoznawanych przez parametr select).

tags_filterobject

Wyrażenie filtra dla tagów promptu. Wymaga report_id. Używa składni filtrów z następującymi ograniczeniami: jedyną prawidłową nazwą pola jest "tag"; jedynymi prawidłowymi operatorami są: "eq", "neq", "substring", "isubstring", "phrase_match", "iphrase_match", "prefix", "suffix", "empty"; maksymalna głębokość zagnieżdżenia and oraz or wynosi 2. Przykład: {"or": [{"field": "tag", "is": ["eq", "branded"]}, {"field": "tag", "is": ["eq", "competitor"]}]}.

limitinteger

Liczba wyników do zwrócenia.

Default:1000
datestring (date)

Data do wyszukania w formacie YYYY-MM-DD.

countryarray<string>

Lista dwuliterowych kodów krajów (ISO 3166-1 alpha-2).

Allowed values:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
Default:
tracked_urlsarray<string>

Lista adresów URL śledzonych stron. Jeśli zostanie podana, odpowiedź zawiera wiersze z zerową liczbą cytowań dla wszystkich śledzonych adresów URL, dla których nie ma danych.

report_idstring

Identyfikator raportu, którego należy użyć. Jeśli zostanie podany, pozostałe parametry są pobierane z raportu (marka, konkurenci, rynek, 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#/...

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.

Allowed values:ahrefscustom
data_sourcearray<string>Required

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

Allowed values:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
marketarray<string>

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

competitorsarray<object>

Lista nazw konkurentów i stron internetowych do wyszukania.

At least one of names or url_groups is required
namesarray<string>

Nazwy marki/konkurenta

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required

Domena celu

Example:ahrefs.com
scopestringrequired

Zakres celu.

Allowed values:urlpathdomainsubdomains
brandsarray<object>

Lista nazw marek i stron internetowych do wyszukania.

At least one of names or url_groups is required
namesarray<string>

Nazwy marki/konkurenta

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required

Domena celu

Example:ahrefs.com
scopestringrequired

Zakres celu.

Allowed values:urlpathdomainsubdomains
outputstring

Format wyjściowy.

Allowed values:jsonphp

Odpowiedzi

pagesarray<object>
mentionsarray<object>

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

responsesinteger

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

urlstring

Adres URL cytowanej strony.

volumeinteger

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