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

Rozdzielona przecinkami lista pól do zwrócenia.

Dostępne pola:

responses
title
url

wherestring

Wyrażenie filtra. Rozpoznawane są następujące identyfikatory kolumn (różnią się 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.

tracked_urlsstring

Rozdzielana przecinkami lista URL-i śledzonych stron. Jeśli zostanie podana, odpowiedź zawiera wiersze z zerową liczbą cytowań dla wszystkich śledzonych URL-i, dla których nie ma danych.

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

titlestring or null

Tytuł strony wyświetlany w cytowaniu odpowiedzi AI lub tytuł strony pobrany podczas crawlowania, jeśli nie zapisano go w żadnej odpowiedzi. null, jeśli żaden z nich nie jest znany.

urlstring

Adres URL cytowanej strony.

volumeinteger

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