Söz Payı

API + MCP

GET/v3/brand-radar/sov-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 (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#/...

brandstring

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

competitorsstring

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

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:jsonphp

Yanıtlar

metricsarray<object>

datestring (date)

share_of_voicearray<object>

(Her marka için 1 birim) Marka için tahmini ses payı.

brandstring

entity_typestring

İzin verilen değerler:aggregatetargetcompetitor

share_of_voicenumber (float)