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ı 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

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.

order_bystring

Sonuçları sıralamak için kullanılacak bir sütun.

İzin verilen değerler:relevancevolume

Varsayılan:relevance

outputstring

Çıktı formatı.

İzin verilen değerler:jsonphp

Yanıtlar

ai_responsesarray<object>

brand_sentimentarray<object>

Yanıtta izlenen bir markaya dair her bahis; önce markalarınız, ardından rakipler kendi sıralarıyla ve yanıtın bu marka hakkında nasıl konuştuğu bilgisiyle birlikte.

brandstring

Bahsi geçen izlenen marka.

sentimentstring or null

Yanıtın bu bahiste marka hakkında nasıl konuştuğu. Mevcut olmadığında null olur.

İzin verilen değerler:positiveneutralnegativemixednull

aspectstring or null

Bahsin neyle ilgili olduğu; örneğin fiyat veya kalite. Mevcut olmadığında null olur.

İzin verilen değerler:features_specsperformance_effectivenessprice_valuereputation_popularityquality_reliabilitydesign_comfortusability_compatibilityavailability_deliverysafety_healthservice_supportgeneralnull

snippetstring or null

Bahsin etrafındaki cümle. Yanıtta bulunamadığında null olur.

countrystring

Sorunun ülkesi.

data_sourcestring

Yanıtı üreten sohbet botu modeli.

funnel_stagestring or null

İstemin huni aşaması. Huni aşaması mevcut değilse null olur.

İzin verilen değerler:awarenessconsiderationdecisionunclearnull

intentarray<string>

İstemin birincil amacı, alt türleri ve markalı/yerel özellikleri dâhil olmak üzere amaç etiketleri. Boş bir dizi, amaç etiketi bulunmadığı anlamına gelir.

İzin verilen değerler:informationalnavigationaltransactionalbrandedcommercialcomparisonhow_tolocalopinionrecommendation

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_changenull

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.