Docs
Dokümanlarda ara...⌘K

Alıntılanan Etki Alanları

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

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

brand_filterobject

Markanızın görünürlüğüne yönelik, “Markanız” filtresini yansıtan bir filtre ifadesi. brand_name, bir yanıtın markanızdan bahsedip bahsetmediğine göre eşleşir: "mentioned" veya "not_mentioned". page_status, yapay zekânın sayfalarınızı nasıl kullandığına göre eşleşir: "cited" (yapay zekâ sitenizdeki sayfalara erişti ve yanıtta bunlara atıfta bulundu), "found_but_not_cited" (yapay zekâ sitenizdeki sayfalara olası kaynaklar olarak erişti ancak nihai yanıtta bunlara atıfta bulunmadı) veya "not_found" (yapay zekâ sitenizdeki hiçbir sayfaya erişmedi).
Şu kısıtlamalarla filtre söz dizimini kullanır: geçerli tek operatör "eq"’dir; her alan ayrı bir bölümdür: tek bir değer verin veya aynı alanın birden fazla değerini or ile birleştirin; brand_name ve page_status bölümlerini en üst düzeyde bir and/or ile birleştirin. Bir alanın tüm değerlerini seçmek, her şeyle eşleşeceği için kabul edilmez (bunun yerine alanı tamamen atlayın).

Example:{"and":[{"field":"brand_name","is":["eq","mentioned"]},{"or":[{"field":"page_status","is":["eq","cited"]},{"field":"page_status","is":["eq","found_but_not_cited"]}]}]}
volume_rangeobject

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

frominteger
tointeger
selectarray<string>Required

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

Mevcut alanlar:
  • domain
  • pages
  • responses
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 gereklidir. Şu kısıtlamalarla filtre söz dizimini kullanır: geçerli tek alan adı "tag"’dir; geçerli operatörler yalnızca ş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.

Example:{"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.

search_volume_typestring

Yapay zekâ görünürlüğü raporları, yapay zekâya göre ayarlanmış hacme geçiyor. Bu metrik, sohbet botları ve yapay zekâ arama yüzeyleri genelinde yapay zekâ yanıtlarına olan talebi daha iyi tahmin eder. Google’a kıyasla her yapay zekâ platformunun tahmini kullanımını temel alarak, Google arama hacmi ayarlanarak hesaplanır. Bu parametre 30 Eylül 2026’da kullanımdan kaldırılacak; tüm istekler yeni yapay zekâya göre ayarlanmış hacmi kullanacak.

İzin verilen değerler:ask_volumekeyword_volume
Default:ask_volume
countryarray<string>

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

İzin verilen değerler:adaeafagaialamaoarasatauawazba…
Default:[]
report_idstring

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

promptsstring

Kullanılacak istemlerin türü. Belirtilmezse her ikisi de kullanılır. Özel istemler için report_id sağlanması gerekir.

İzin verilen değerler:ahrefscustom
data_sourcearray<string>Required

Sohbet botu modellerinin listesi. Tüm modeller birbiriyle birlikte kullanılabilir. claude modülü yalnızca özel istemleri destekler.
google_ai_overviews_keywords ve google_ai_mode_keywords modelleri, istemlerden ziyade Google arama sorgularından (anahtar kelimelerden) elde edilen AI Overviews / AI Mode görünürlüğünü raporlar.

İzin verilen değerler:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_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ı.

İzin verilen değerler: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ı.

İzin verilen değerler:urlpathdomainsubdomains
outputstring

Çıktı formatı.

İzin verilen değerler:jsonphp

Yanıtlar

domainsarray<object>
domainstring

Kaynak gösterilen alan adı.

mentionsarray<object>

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

pagesinteger

Yanıtlarda kaynak gösterilen alan adına ait benzersiz sayfa sayısı.

responsesinteger

Alan adını kaynak gösteren yanıt sayısı.

volumeinteger

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