Bahsetmeler

API + MCP

GET/v3/brand-radar/mentions-history

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.

Sorgu parametreleri

wherestring

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#/...

brandstringGerekli

Aranacak marka.

data_sourcestringGerekli

Virgülle ayrılmış bir chatbot model listesi. Tüm modeller birbirleriyle birlikte kullanılabilir. claude modülü yalnızca özel istemleri destekler.
google_ai_overviews_keywords ve google_ai_mode_keywords modelleri, istemler yerine Google arama sorgularından (anahtar kelimelerden) türetilen AI Overview / yapay zekâ modu görünürlüğünü raporlar.

İzin verilen değerler:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

countrystring

İki harfli ülke kodlarının (ISO 3166-1 alpha-2) virgülle ayrılmış listesi.

İzin verilen değerler:adaeafagaialamaoarasatauawazba…

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

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.

outputstring

Çıktı formatı.

İzin verilen değerler:jsoncsvxmlphp

Yanıtlar

metricsarray<object>

datestring (date)

mentionsinteger

Markadan bahseden yanıtlara dayalı tahmini bahsetme sayısı.