Cytowane strony

API + MCP

GET/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.

Parametry zapytania

selectstringWymagane

Lista pól zwracanych w odpowiedzi, rozdzielonych przecinkami.

Dostępne pola:

responses
url

wherestring

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

limitinteger

Liczba wyników do zwrócenia.

Domyślne:1000

datestring (date)

Data do wyszukania w formacie YYYY-MM-DD.

countrystring

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

Dozwolone wartości:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

tracked_urlsstring

Rozdzielana przecinkami 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.

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

competitorsstring

Rozdzielana przecinkami lista konkurentów Twoich marek.

brandstring

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

outputstring

Format wyjściowy.

Dozwolone wartości: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.