Ringkasan - Tayangan

API + MCP

GET/v3/brand-radar/impressions-overview

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

selectstringWajib

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

wherestring

Daftar kolom yang dipisahkan koma untuk dikembalikan.

report_idstring

Laporan visibilitas AI beralih ke volume AI yang disesuaikan. Ini lebih baik dalam memperkirakan permintaan terhadap respons AI di berbagai chatbot dan permukaan penelusuran AI. Perhitungannya dilakukan dengan menyesuaikan volume pencarian Google berdasarkan perkiraan penggunaan tiap platform AI dibandingkan dengan Google. Parameter ini akan dihentikan pada 30 September 2026; semua permintaan akan menggunakan volume AI yang disesuaikan yang baru.

brandstring

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

competitorsstring

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

data_sourcestringWajib

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

Nilai yang diizinkan:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotclaudegrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

countrystring

Daftar model chatbot yang dipisahkan koma. Semua model dapat digabungkan 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:adaeafagaialamaoarasatauawazba…

promptsstring

Daftar pasar niche untuk brand Anda yang dipisahkan koma. Dihentikan pada 2026-05-18, parameter ini tidak akan berpengaruh tidak lama setelah tanggal tersebut.

Nilai yang diizinkan:ahrefscustom

search_volume_typestring

Daftar kompetitor untuk brand Anda yang dipisahkan koma.

Nilai yang diizinkan:ask_volumekeyword_volume

Default:ask_volume

outputstring

Format output.

Nilai yang diizinkan:jsoncsvxmlphp

Respons

metricsarray<object>

brandstring

Nama merek (baik merek Anda maupun pesaing yang disertakan dalam permintaan).

no_tracked_brandsinteger

Perkiraan impresi dari respons yang terkait dengan pasar yang ditentukan dan tidak menyebutkan merek apa pun yang diberikan (nilainya nol ketika market tidak ditentukan).

only_competitors_brandsinteger

Perkiraan impresi dari respons yang hanya menyebutkan merek pesaing.

only_target_brandinteger

Perkiraan impresi dari respons yang hanya menyebutkan merek Anda.

target_and_competitors_brandsinteger

Perkiraan impresi dari respons yang menyebutkan merek Anda dan merek pesaing.

totalinteger

Total perkiraan impresi untuk merek Anda (mencakup only_target_brand dan target_and_competitors_brands).