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

wherestring

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

selectstringWajib

Daftar kolom yang dipisahkan koma untuk dikembalikan.

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 lainnya diambil dari laporan (merek, kompetitor, pasar, negara, filter). Jika negara atau filter diberikan, keduanya 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.

competitorsstring

Daftar kompetitor merek Anda yang dipisahkan koma.

brandstring

Daftar merek yang akan dicari, dipisahkan koma. Setidaknya salah satu dari brand, competitors, market, atau where tidak boleh kosong.

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