Bahsetmeler

API + MCP

POST/v3/brand-radar/mentions-overview

Bu uç noktaya yapılan istekler, prompts parametresine bağlı olarak API birimi harcar: 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 (ve geçerliyse competitors içinde) sağlanan her varlık, names içinde en az bir değer içermelidir. Yalnızca url_groups’tan oluşan varlıklar burada desteklenmez; çünkü bahsedilmeler marka adlarıyla eşleştirilir.

İstek gövdesi

selectarray<string>Required

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

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

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>

brandstring

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

entity_typestring

Satırın bir toplamı, hedef markanızı veya bir rakibi temsil edip etmediğini belirtir.

İzin verilen değerler:aggregatetargetcompetitor

no_tracked_brandsinteger

Belirtilen pazarla ilgili yanıtlardan, sağlanan markaların hiçbirinden bahsetmeyenlerin tahmini bahsedilme sayısı (market belirtilmediğinde değer sıfırdır).

only_competitors_brandsinteger

Yalnızca rakip markalardan bahseden yanıtlardan elde edilen tahmini bahsedilme sayısı.

only_target_brandinteger

Yalnızca kendi markanızdan bahseden yanıtlardan elde edilen tahmini bahsedilme sayısı.

target_and_competitors_brandsinteger

Hem kendi markanızdan hem de rakip markalardan bahseden yanıtlardan elde edilen tahmini bahsedilme sayısı.

totalinteger

Markanız için toplam tahmini bahsedilme sayısı (only_target_brand ve target_and_competitors_brands dahil).