Genel bakış - Bahsetmeler

API + MCP

GET/v3/brand-radar/mentions-overview

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 parametresinin tanıdığı tanımlayıcılardan farklıdır).

selectstringGerekli

Döndürülecek alanların virgülle ayrılmış bir listesi.

countrystring

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

İzin verilen değerler:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

report_idstring

Kullanılacak raporun kimliği. 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. 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ğlanmalıdır.

İzin verilen değerler:ahrefscustom

data_sourcestringGerekli

Virgülle ayrılmış bir sohbet botu modeli listesi. Google anahtar kelime modelleri (google_ai_overviews_keywords, google_ai_mode_keywords) birbirleriyle veya diğer modellerle birlikte kullanılamaz.

İzin verilen değerler:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

marketstring

Markalarınızın niş pazarlarının virgülle ayrılmış 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.

competitorsstring

Markalarınızın rakiplerinin virgülle ayrılmış listesi.

brandstring

Aranacak markaların virgülle ayrılmış listesi. Brand, competitors, market veya where parametrelerinden en az biri boş olmamalıdır.

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