Genel bakış geçmişi - 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ı desteklenir (bunlar, select parametresi tarafından tanınan tanımlayıcılardan farklıdır).

date_tostring (date)

YYYY-MM-DD formatında geçmiş dönemin bitiş tarihi.

date_fromstring (date)Gerekli

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

search_volume_typestring

Yapay zekâ görünürlük raporları, yapay zekâya göre ayarlanmış hacme geçiyor. Bu metrik, sohbet botları ve yapay zekâ destekli arama alanlarında yapay zekâ yanıtlarına olan talebi daha iyi tahmin eder. Google arama hacminin, her yapay zekâ platformunun Google’a kıyasla tahmini kullanımına göre ayarlanmasıyla hesaplanır. Bu parametre 31 Ağustos 2026’da kullanımdan kaldırılacak; tüm isteklerde yeni yapay zekâya göre ayarlanmış hacim kullanılacaktır.

İzin verilen değerler:ask_volumekeyword_volume

Varsayılan:ask_volume

countrystring

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

İzin verilen değerler:adaeafagaialamaoarasatauawazba…

report_idstring

Kullanılacak rapor kimliği. Bir rapor belirtilirse 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#/...

promptsstring

Kullanılacak istemlerin türü. Belirtilmezse her ikisi de kullanılır. Özel istemler için report_id sağlanması gerekir.

İzin verilen değerler:ahrefscustom

data_sourcestringGerekli

Sohbet botu modellerinin virgülle ayrılmış 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

Example:chatgpt,perplexity

marketstring

Markalarınızın niş pazarlarını içeren virgülle ayrılmış liste. 2026-05-18 itibarıyla kullanımdan kaldırılmıştır; bu tarihten kısa bir süre sonra bu parametrenin hiçbir etkisi olmayacaktır.

competitorsstring

Markalarınızın rakiplerini içeren virgülle ayrılmış liste.

brandstring

Aranacak markaları içeren virgülle ayrılmış liste. brand, competitors, market veya where parametrelerinden en az biri boş olmamalıdır.

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

share_of_voicenumber (float)