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

API + MCP

GET/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.

Sorgu parametreleri

wherestring

Filtre ifadesi. Aşağıdaki sütun tanımlayıcıları tanınır (bu, select parametresinin tanıdığı tanımlayıcılardan farklıdır).

cited_domain: Yanıtın oluşturulmasında kullanılan bir sayfanın alan adı.
tür: domain

cited_domain_subdomains: Yanıtın oluşturulmasında kullanılan bir sayfanın alan adı. Verilen alan adının herhangi bir alt alan adı da eşleşir.
tür: string

cited_url_exact: Yanıtın oluşturulmasında kullanılan bir sayfanın URL’si.
tür: string

cited_url_prefix: Yanıtın oluşturulmasında kullanılan bir sayfanın URL’si. Bu önekle başlayan herhangi bir URL eşleşir.
tür: string

question: Kullanıcının sorduğu soru.
tür: string

response (10 birim): Modelin yanıtı.
tür: string

search_queries: Chatbot’un 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.
tür: string

topic: Sorgunun konusu.
tür: string

date_tostring (date)

YYYY-MM-DD biçiminde, geçmiş döneminin bitiş tarihi.

date_fromstring (date)Gerekli

YYYY-MM-DD biçiminde, geçmiş döneminin başlangıç tarihi.

countrystring

İki harfli ülke kodlarının (ISO 3166-1 alpha-2) virgülle ayrılmış listesi.

İzin verilen değerler:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

report_idstring

Kullanılacak raporun kimliği. Verilirse diğer parametreler rapordan alınır (market, country, filters). country veya filters 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 istem türü. Belirtilmezse her ikisi de kullanılır. Özel istemler için report_id sağlanmalıdır.

İzin verilen değerler:ahrefscustom

data_sourcestringGerekli

Virgülle ayrılmış bir sohbet botu modeli listesi. Google anahtar kelime modelleri (google_ai_overviews_keywords, google_ai_mode_keywords) birbirleriyle veya diğer modellerle birlikte kullanılamaz.

İzin verilen değerler:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

marketstring

Markalarınızın niş pazarlarının virgülle ayrılmış bir listesi. 2026-05-18 tarihinde kullanımdan kaldırılmıştır; bu parametre bu tarihten kısa bir süre sonra etkisiz olacaktır.

brandstringGerekli

Aranacak marka.

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