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

selectstringGerekli

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

wherestring

Filtre ifadesi. Aşağıdaki sütun tanımlayıcıları desteklenir (bu, select parametresinin desteklediği 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

limitinteger

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

Varsayılan:1000

datestring (date)

YYYY-MM-DD biçiminde aranacak tarih.

date_comparedstring (date)

date ile karşılaştırılacak tarih (YYYY-MM-DD biçiminde). date değerinden 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 raporlar. Yalnızca date_compared tarihinde yanıtlanan bir istem lost olarak raporlanır; diğer alanlarının geri kalanı ise date_compared yanıtını açıklar, çünkü date tarihinde buna ait bir yanıt yoktur.

search_volume_typestring

Yapay zekâ görünürlük raporları, yapay zekâya göre ayarlanmış hacme geçiyor. Bu, chatbot’lar ve yapay zekâ arama yüzeyleri genelinde yapay zekâ yanıtlarına olan talebi daha iyi tahmin eder. Her bir yapay zekâ platformunun Google’a kıyasla tahmini kullanımını dikkate alarak Google arama hacmi ayarlanarak hesaplanır. Bu parametre 30 Eylül 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

order_bystring

Sonuçların hangi sütuna göre sıralanacağı.

İzin verilen değerler:relevancevolume

Varsayılan:relevance

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.