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

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.

search_volume_typestring

Laporan visibilitas AI beralih ke volume yang disesuaikan untuk AI. Metode ini memperkirakan permintaan respons AI di berbagai chatbot dan layanan pencarian AI dengan lebih baik. Volume ini dihitung dengan menyesuaikan volume pencarian Google berdasarkan perkiraan penggunaan setiap platform AI dibandingkan dengan Google. Parameter ini akan dihentikan pada 31 Agustus 2026; semua permintaan akan menggunakan volume baru yang disesuaikan untuk AI.

Nilai yang diizinkan:ask_volumekeyword_volume

Default:ask_volume

countrystring

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

Nilai yang diizinkan:adaeafagaialamaoarasatauawazba…

report_idstring

ID laporan yang akan digunakan. Jika ID diberikan, parameter lainnya diambil dari laporan (pasar, negara, filter). Jika negara atau filter diberikan, nilai tersebut akan menggantikan nilai 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 disertakan.

Nilai yang diizinkan:ahrefscustom

data_sourcestringWajib

Daftar model chatbot yang dipisahkan dengan koma. Semua model dapat dikombinasikan satu sama lain. Modul claude hanya mendukung prompt kustom.
Model google_ai_overviews_keywords dan google_ai_mode_keywords melaporkan visibilitas AI Overviews / AI Mode yang diperoleh dari kueri pencarian Google (kata kunci), bukan dari prompt.

Nilai yang diizinkan:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

marketstring

Daftar ceruk pasar merek Anda yang dipisahkan dengan koma. Mulai tidak digunakan lagi pada 2026-05-18, parameter ini akan segera tidak berpengaruh 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.