Docs
Dokümanlarda ara...⌘K

Alıntılanan Sayfalar

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

Bu uç noktaya yapılan istekler, prompts parametresine göre API birimleri tüketir: yalnızca özel istem verisi döndüren istekler ücretsizdir; Ahrefs istem verisini içeren istekler ise standart API birim ücretlendirmesine tabidir.

İstek gövdesi

volume_rangeobject

Filtreleme için kullanılacak hacim aralığı.

frominteger
tointeger
selectarray<string>Required

Döndürülecek alanların bir listesi.

Mevcut alanlar:
  • responses
  • url
Example:["field_a","field_b"]
whereobject

Filtre ifadesi. Aşağıdaki sütun tanımlayıcıları tanınır (bu, select parametresinin tanıdığı tanımlayıcılardan farklıdır).

tags_filterobject

İstem etiketleri için bir filtre ifadesi. report_id gerektirir. Aşağıdaki kısıtlamalarla birlikte filtre söz dizimini kullanır: tek geçerli alan adı "tag"'dir; tek geçerli operatörler şunlardır: "eq", "neq", "substring", "isubstring", "phrase_match", "iphrase_match", "prefix", "suffix", "empty"; and ve or için maksimum iç içe geçme derinliği 2'dir. Örnek: {"or": [{"field": "tag", "is": ["eq", "branded"]}, {"field": "tag", "is": ["eq", "competitor"]}]}.

limitinteger

Döndürülecek sonuç sayısı.

Default:1000
datestring (date)

YYYY-AA-GG biçiminde aranacak tarih.

countryarray<string>

İki harfli ülke kodlarının (ISO 3166-1 alfa-2) listesi.

Allowed values:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
Default:
tracked_urlsarray<string>

Takip edilen sayfa URL’lerinin listesi. Sağlandığında yanıt, veri olmayan takip edilen URL’ler için sıfır atıf içeren satırları da içerir.

report_idstring

Kullanılacak raporun kimliği. Bir rapor verilirse diğer parametreler rapordan alınır (marka, rakipler, pazar, ülke, filtreler). Ülke veya filtreler sağlanırsa rapordakilerin yerine geçer. Ahrefs’teki Brand Radar raporunuzun URL’sinde bulabilirsiniz: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

promptsstring

Kullanılacak istem türü. Belirtilmezse her ikisi de kullanılır. Özel istemler için report_id sağlanmalıdır.

Allowed values:ahrefscustom
data_sourcearray<string>Required

Bir sohbet botu modeli listesi. Google anahtar kelime modelleri (google_ai_overviews_keywords, google_ai_mode_keywords) birbirleriyle veya diğer modellerle birlikte kullanılamaz.

Allowed values:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
marketarray<string>

Markalarınızın niş pazarlarının bir listesi. 2026-05-18 tarihinde kullanımdan kaldırılmıştır; bu parametre bu tarihten kısa bir süre sonra etkisiz olacaktır.

competitorsarray<object>

Aranacak rakip adları ve web sitelerinin listesi.

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

Marka/rakibin adları

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

Hedefin alan adı

Example:ahrefs.com
scopestringrequired

Hedefin kapsamı.

Allowed values:urlpathdomainsubdomains
brandsarray<object>

Aranacak marka adları ve web sitelerinin listesi.

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

Marka/rakibin adları

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

Hedefin alan adı

Example:ahrefs.com
scopestringrequired

Hedefin kapsamı.

Allowed values:urlpathdomainsubdomains
outputstring

Çıktı formatı.

Allowed values:jsonphp

Yanıtlar

pagesarray<object>
mentionsarray<object>

2026-02-10 tarihinde kullanımdan kaldırıldı.

responsesinteger

Sayfayı kaynak gösteren yanıt sayısı.

urlstring

Kaynak gösterilen sayfanın URL’si.

volumeinteger

2026-03-24 tarihinde kullanımdan kaldırıldı.