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

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 parametresi tarafından tanınan tanımlayıcılardan farklıdır).

report_idstring

Kullanılacak raporun ID’si. 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. Bunu, Ahrefs’teki Brand Radar raporunuzun URL’sinde bulabilirsiniz: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

brandsarray<object>

Aranacak marka adları ve web sitelerinin listesi.

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

Marka/rakip 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
competitorsarray<object>

Aranacak rakip adları ve web sitelerinin listesi.

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

Marka/rakip 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
content_filterobject

İçeriklerine göre sonuçları dahil etmek veya hariç tutmak için kullanılan isteğe bağlı ifadeler.

includearray<string>

Yalnızca bu tam ifadelerden en az birini içeren sonuçları göster.

excludearray<string>

Bu tam ifadelerden herhangi birini içeren sonuçları gizle.

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
countryarray<string>

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

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

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

İzin verilen değerler:ahrefscustom
limitinteger

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

Default:1000
datestring (date)

YYYY-MM-DD biçiminde aranacak tarih.

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" ] } ] }
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
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ı.