Docs
Dokümanlarda ara...⌘K

Alıntılar

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ı 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 (ü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#/...

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
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
date_fromstring (date)Required

Geçmiş dönemin YYYY-MM-DD formatındaki başlangıç tarihi.

date_tostring (date)

Geçmiş dönemin YYYY-MM-DD formatındaki bitiş tarihi.

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