Docs
Cari dokumen...⌘K

Riwayat ringkasan - Penyebutan

API + MCP
POST/v3/brand-radar/mentions-history

Permintaan ke endpoint ini menggunakan unit API berdasarkan parameter prompts: permintaan yang hanya mengembalikan data prompt kustom tidak dikenai biaya, sedangkan permintaan yang menyertakan data prompt Ahrefs mengikuti harga unit API standar.

Setiap entitas yang disediakan dalam brands (dan competitors, jika berlaku) harus menyertakan setidaknya satu nilai dalam names. Entitas yang hanya terdiri atas url_groups tidak didukung di sini karena penyebutan dicocokkan berdasarkan nama merek.

Isi permintaan

whereobject

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

tags_filterobject

Ekspresi filter untuk tag prompt. Memerlukan report_id. Menggunakan sintaks filter dengan batasan berikut: satu-satunya nama kolom yang valid adalah "tag"; operator yang valid hanya: "eq", "neq", "substring", "isubstring", "phrase_match", "iphrase_match", "prefix", "suffix", "empty"; kedalaman nesting maksimum untuk and, or adalah 2. Contoh: {"or": [{"field": "tag", "is": ["eq", "branded"]}, {"field": "tag", "is": ["eq", "competitor"]}]}.

date_tostring (date)

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

date_fromstring (date)Required

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

countryarray<string>

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

Allowed values:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
Default:
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.

Allowed values:ahrefscustom
data_sourcearray<string>Required

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

Allowed values:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords
marketarray<string>

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

brandsarray<object>

Daftar nama merek dan situs web yang akan dicari.

Default:
At least one of names or url_groups is required
namesarray<string>

Nama merek/kompetitor

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required

Domain target

Example:ahrefs.com
scopestringrequired

Cakupan target.

Allowed values:urlpathdomainsubdomains
outputstring

Format output.

Allowed values:jsoncsvxmlphp

Respons

metricsarray<object>
datestring (date)
mentionsinteger

Perkiraan jumlah penyebutan dari respons yang menyebut merek.