Genel Bakış - Atıflar

API + MCP

POST/v3/brand-radar/citations-overview

Bu uç noktaya yapılan istekler, prompts parametresine göre API birimi tüketir: Yalnızca özel istem verilerini döndüren istekler ücretsizdir; Ahrefs istem verilerini içeren istekler ise standart API birimi fiyatlandırmasına tabidir.

brands içinde sağlanan her varlık (ve geçerliyse competitors), url_groups alanında en az bir değer bulundurmalıdır. Yalnızca names içeren varlıklar burada desteklenmez; çünkü atıflar URL gruplarıyla eşleştirilir.

İstek gövdesi

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

selectarray<string>Required

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

Example:["field_a","field_b"]

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

search_volume_typestring

Yapay zekâ görünürlük 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 yönelik talebi daha iyi tahmin eder. Google ile karşılaştırıldığında her yapay zekâ platformunun tahmini kullanımını baz alıp Google arama hacmini buna göre ayarlayarak hesaplanır. Bu parametre 30 Eylül 2026’da kullanımdan kaldırılacaktır; 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 raporun kimliği. Verilirse diğer parametreler rapordan alınır (marka, rakipler, pazar, ülke, filtreler). Ülke veya filtreler sağlanırsa rapordakilerin üzerine yazar. 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ğ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.

Min.:1

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:jsoncsvxmlphp

Yanıtlar

metricsarray<object>

brandstring

Marka adı (kendi markanız veya istekte belirtilen bir rakip).

no_tracked_brandsinteger

Belirtilen pazarla ilgili olup sağlanan marka URL’lerinden hiçbirini içermeyen yanıtlardan elde edilen tahmini atıflar (market belirtilmediğinde değer sıfırdır).

only_competitors_brandsinteger

Yalnızca rakip marka URL’lerini içeren yanıtlardan elde edilen tahmini atıflar.

only_target_brandinteger

Yalnızca marka URL’lerinizi içeren yanıtlardan elde edilen tahmini atıflar.

target_and_competitors_brandsinteger

Hem marka URL’lerinizi hem de rakip marka URL’lerini içeren yanıtlardan elde edilen tahmini atıflar.

totalinteger

Marka URL’leriniz için toplam tahmini atıf sayısı (only_target_brand ve target_and_competitors_brands dâhil).

curl "https://api.ahrefs.com/v3/brand-radar/citations-overview" \ -X POST \ -H "Authorization: Bearer $AHREFS_API_KEY" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ --data-raw '{ "where": {}, "select": ["field_a","field_b"], "tags_filter": {"or":[{"field":"tag","is":["eq","branded"]},{"field":"tag","is":["eq","competitor"]}]}, "search_volume_type": "ask_volume", "country": ["ad"], "report_id": "string", "prompts": "ahrefs", "data_source": ["chatgpt"], "market": ["string"], "competitors": [ { "names": ["ahrefs","ahrefs seo"], "url_groups": [ { "target": "ahrefs.com", "scope": "url" } ] } ], "brands": [ { "names": ["ahrefs","ahrefs seo"], "url_groups": [ { "target": "ahrefs.com", "scope": "url" } ] } ], "output": "json" }'

{ "metrics": [ { "brand": "string", "no_tracked_brands": 0, "only_competitors_brands": 0, "only_target_brand": 0, "target_and_competitors_brands": 0, "total": 0 } ] }