İzlenimler

API + MCP

GET/v3/brand-radar/impressions-overview

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

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

outputstring

Çıktı formatı.

İzin verilen değerler:jsoncsvxmlphp

Yanıtlar

metricsarray<object>

brandstring

Marka adı (kendi markanız veya istekte belirtilen bir rakip).

no_tracked_brandsinteger

Belirtilen pazarla ilgili yanıtlardan, sağlanan markaların hiçbirinden bahsetmeyenlerin tahmini izlenimleri (market belirtilmediğinde değer sıfırdır).

only_competitors_brandsinteger

Yalnızca rakip markalardan bahseden yanıtlardan elde edilen tahmini izlenimler.

only_target_brandinteger

Yalnızca kendi markanızdan bahseden yanıtlardan elde edilen tahmini izlenimler.

target_and_competitors_brandsinteger

Hem kendi markanızdan hem de rakip markalardan bahseden yanıtlardan elde edilen tahmini izlenimler.

totalinteger

Markanız için toplam tahmini izlenimler (only_target_brand ve target_and_competitors_brands dahil).