Docs
Dokümanlarda ara...⌘K

Genel bakış geçmişi - Gösterimler

API + MCP
POST/v3/brand-radar/impressions-history

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.

İstek gövdesi

whereobject

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 (ülke, filtreler). Ülke veya filtreler sağlanırsa rapordakilerin yerine geçer. Ahrefs’teki Brand Radar raporunuzun URL’sinde bulabilirsiniz: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

brandsarray<object>

Aranacak marka adları ve web sitelerinin listesi.

Default:[]
At least one of names or url_groups is required
namesarray<string>

Marka/rakip adları

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required

Hedefin alan adı

Example:ahrefs.com
scopestringrequired

Hedefin kapsamı.

İzin verilen değerler:urlpathdomainsubdomains
data_sourcearray<string>Required

Sohbet botu modellerinin 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
countryarray<string>

İki harfli ülke kodlarının (ISO 3166-1 alfa-2) listesi.

İzin verilen değerler:adaeafagaialamaoarasatauawazba…
Default:[]
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
date_fromstring (date)Required

YYYY-MM-DD formatında geçmiş dönemin başlangıç tarihi.

date_tostring (date)

YYYY-MM-DD formatında geçmiş dönemin bitiş tarihi.

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
Default:ask_volume
tags_filterobject

İstem etiketleri için bir filtre ifadesi. report_id gereklidir. Şu kısıtlamalarla filtre söz dizimini kullanır: geçerli tek alan adı "tag"’dir; geçerli operatörler yalnızca şunlardır: "eq", "neq", "substring", "isubstring", "phrase_match", "iphrase_match", "prefix", "suffix", "empty"; and ve or için maksimum iç içe geçme derinliği 2’dir.

Example:{"or":[{"field":"tag","is":["eq","branded"]},{"field":"tag","is":["eq","competitor"]}]}
outputstring

Çıktı formatı.

İzin verilen değerler:jsoncsvxmlphp

Yanıtlar

metricsarray<object>
datestring (date)
impressionsinteger

Markadan bahseden yanıtlara dayalı tahmini gösterim sayısı.