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ış bir listesi.

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

limitinteger

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

Varsayılan:1000

datestring (date)

YYYY-AA-GG 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â 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…

order_bystring

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

İzin verilen değerler:relevancevolume

Varsayılan:relevance

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

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.

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.