Riwayat ringkasan - Tayangan

API + MCP

GET/v3/brand-radar/impressions-history

Permintaan ke endpoint ini akan menghabiskan unit API berdasarkan parameter prompts: permintaan yang hanya mengembalikan data prompt kustom gratis, sedangkan permintaan yang menyertakan data prompt Ahrefs mengikuti penetapan harga unit API Standard.

Parameter kueri

wherestring

Ekspresi filter. Pengidentifikasi kolom berikut dikenali (ini berbeda dari pengidentifikasi yang dikenali oleh parameter select).

cited_domain: Domain dari halaman yang digunakan untuk menghasilkan respons.
tipe: domain

cited_domain_subdomains: Domain dari halaman yang digunakan untuk menghasilkan respons. Subdomain apa pun dari domain yang diberikan juga akan cocok.
tipe: string

cited_url_exact: URL dari halaman yang digunakan untuk menghasilkan respons.
tipe: string

cited_url_prefix: URL dari halaman yang digunakan untuk menghasilkan respons. URL apa pun yang diawali dengan prefiks ini akan cocok.
tipe: string

question: Pertanyaan yang diajukan oleh pengguna.
tipe: string

response (10 unit): Respons dari model.
tipe: string

search_queries: Kueri penelusuran yang digunakan chatbot untuk menemukan informasi untuk respons. Catatan: jika data_source tidak menyertakan chatgpt atau perplexity, kolom ini akan selalu kosong.
tipe: string

topic: Topik kueri.
tipe: string

date_tostring (date)

Tanggal akhir periode historis dalam format YYYY-MM-DD.

date_fromstring (date)Wajib

Tanggal mulai periode historis dalam format YYYY-MM-DD.

countrystring

Daftar kode negara dua huruf (ISO 3166-1 alpha-2) yang dipisahkan dengan koma.

Nilai yang diizinkan:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

report_idstring

ID Laporan yang akan digunakan. Jika diberikan, parameter lain diambil dari laporan (market, country, filters). Jika country atau filters disediakan, nilainya akan menimpa yang ada di laporan. Anda dapat menemukannya di URL laporan Brand Radar Anda di Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

promptsstring

Jenis prompt yang akan digunakan. Jika tidak ditentukan, keduanya akan digunakan. Prompt kustom mengharuskan report_id disediakan.

Nilai yang diizinkan:ahrefscustom

data_sourcestringWajib

Daftar model chatbot yang dipisahkan dengan koma. Model kata kunci Google (google_ai_overviews_keywords, google_ai_mode_keywords) tidak dapat digabungkan satu sama lain maupun dengan model lain.

Nilai yang diizinkan:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

marketstring

Daftar pasar niche merek Anda yang dipisahkan dengan koma. Tidak digunakan lagi sejak 2026-05-18, parameter ini tidak akan berpengaruh segera setelah tanggal tersebut.

brandstringWajib

Merek yang akan dicari.

outputstring

Format output.

Nilai yang diizinkan:jsoncsvxmlphp

Respons

metricsarray<object>

datestring (date)

impressionsinteger

Perkiraan impresi dari respons yang menyebutkan merek tersebut.