Docs
Dokümanlarda ara...⌘K

Genel bakış geçmişi - Atıflar

API + MCP
POST/v3/brand-radar/citations-history

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ı desteklenir (bunlar, select parametresi tarafından tanınan 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"]}]}
date_tostring (date)

YYYY-MM-DD biçiminde, geçmiş döneminin bitiş tarihi.

date_fromstring (date)Required

YYYY-MM-DD biçiminde, geçmiş döneminin başlangıç tarihi.

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â destekli arama alanlarında yapay zekâ yanıtlarına olan talebi daha iyi tahmin eder. Google arama hacminin, her yapay zekâ platformunun Google’a kıyasla tahmini kullanımına göre ayarlanmasıyla hesaplanır. Bu parametre 31 Ağustos 2026’da kullanımdan kaldırılacak; tüm isteklerde yeni yapay zekâya göre ayarlanmış hacim kullanılacaktır.

İ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. Bir rapor belirtilirse diğer parametreler rapordan alınır (market, country, filters). country veya filters belirtilirse, 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.

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>
citationsinteger

Marka URL’lerini içeren yanıtlardan elde edilen tahmini atıflar.

datestring (date)