Yapay Zekâ Yanıtları

API + MCP

GET/v3/brand-radar/ai-responses

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

date_comparedstring (date)

date ile karşılaştırılacak tarih (YYYY-MM-DD biçiminde). date tarihinden kesinlikle daha erken olmalıdır. Ayarlandığında rapor, iki tarihten herhangi birinde yanıtlanan her istemi kapsar ve status alanı her birinin bu iki tarih arasında nasıl değiştiğini bildirir. Yalnızca date_compared tarihinde yanıtlanan bir istem lost olarak raporlanır; date tarihinde yanıtı olmadığı için kalan alanları date_compared yanıtını açıklar.

selectstringGerekli

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

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

limitinteger

Döndürülecek sonuç sayısı.

Varsayılan:1000

datestring (date)

YYYY-MM-DD biçiminde aranacak tarih.

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â arama yüzeyleri genelinde yapay zekâ yanıtlarına yönelik talebi daha iyi tahmin eder. Google ile karşılaştırıldığında her yapay zekâ platformunun tahmini kullanımını baz alıp Google arama hacmini buna göre ayarlayarak hesaplanır. Bu parametre 30 Eylül 2026’da kullanımdan kaldırılacaktır; tüm istekler yeni yapay zekâya göre ayarlanmış hacmi kullanacak.

İzin verilen değerler:ask_volumekeyword_volume

Varsayılan:ask_volume

countrystring

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

İzin verilen değerler:adaeafagaialamaoarasatauawazba…

order_bystring

Sonuçların sıralanacağı sütun.

İzin verilen değerler:relevancevolume

Varsayılan:relevance

report_idstring

Kullanılacak raporun kimliği. Verilirse diğer parametreler rapordan alınır (marka, rakipler, pazar, ülke, filtreler). Ülke veya filtreler sağlanırsa rapordakilerin üzerine yazar. 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ğlanması gerekir.

İzin verilen değerler:ahrefscustom

data_sourcestringGerekli

Sohbet botu modellerinin virgülle ayrılmış listesi. Tüm modeller birbiriyle birleştirilebilir. 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 kelimeler) türetilen AI Overview / 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ın virgülle ayrılmış listesi. 2026-05-18 tarihinde kullanımdan kaldırıldı; bu tarihten kısa süre sonra bu parametrenin hiçbir etkisi olmayacak.

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 alanlarından en az biri boş olmamalıdır.

outputstring

Çıktı formatı.

İzin verilen değerler:jsonphp

Yanıtlar

ai_responsesarray<object>

countrystring

Sorunun ülkesi.

data_sourcestring

Yanıtı üreten sohbet botu modeli.

last_updatedstring (date)

Verilerin en son güncellendiği tarih.

linksarray<object>

(10 birim) Yanıt için kullanılan bağlantılar.

urlstring

titlestring or null

questionstring

Kullanıcının sorduğu soru.

responsestring

(10 birim) Modelin yanıtı.

search_queriesarray<string>

Sohbet botunun yanıt için bilgi bulmak üzere kullandığı arama sorgusu. Not: data_source içinde chatgpt veya perplexity yoksa bu alan her zaman boş olur.

statusstring or null

İstemin date_compared ile date arasında nasıl değiştiği. date_compared ayarlanmadıkça null olur. new — date tarihinde yanıtlandı ama date_compared tarihinde yanıtlanmadı. lost — date_compared tarihinde yanıtlandı ama date tarihinde yanıtlanmadı; bu satırın geri kalanı, date tarihinde yanıt olmadığı için date_compared yanıtını açıklar. no_change — her iki tarihte de yanıtlandı; bu, yanıtın kendisinin, bahsettiklerinin veya alıntılarının değişip değişmediğine dair bir şey söylemez.

İzin verilen değerler:newlostno_change

tagsarray<string>

Sorguya atanan etiketler.

volumeinteger

(10 birim) Tahmini aylık arama hacmi. Bu değer, Google için yaptığımız tahminlere dayanır ve bu sorunun "People Also Ask" bölümünde göründüğü ilgili anahtar kelimelerin arama hacimlerinin birleştirilmesiyle hesaplanır.