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. Pengenal kolom berikut dikenali (ini berbeda dari pengenal yang dikenali oleh parameter select).

report_idstring

ID laporan yang akan digunakan. Jika diberikan, parameter lain diambil dari laporan (negara, filter). Jika negara atau filter disediakan, nilai tersebut akan menimpa yang ada di laporan. Anda bisa menemukannya di URL laporan Brand Radar Anda di Ahrefs: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

brandstringWajib

Merek yang akan dicari.

data_sourcestringWajib

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

Nilai yang diizinkan:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

countrystring

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

Nilai yang diizinkan:adaeafagaialamaoarasatauawazba…

promptsstring

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

Nilai yang diizinkan:ahrefscustom

date_fromstring (date)Wajib

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

date_tostring (date)

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

outputstring

Format output.

Nilai yang diizinkan:jsoncsvxmlphp

Respons

metricsarray<object>

datestring (date)

impressionsinteger

Perkiraan impresi dari respons yang menyebutkan merek tersebut.