Docs
Cari dokumen...⌘K

Share of Voice

API + MCP
POST/v3/brand-radar/sov-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.

Isi permintaan

whereobject

Ekspresi filter. Identifier kolom berikut dikenali (ini berbeda dari identifier yang dikenali oleh parameter select).

report_idstring

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#/...

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/pesaing

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

Domain target

Example:ahrefs.com
scopestringrequired

Cakupan target.

Nilai yang diizinkan:urlpathdomainsubdomains
competitorsarray<object>

Daftar nama kompetitor dan situs web yang akan dicari.

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

Nama merek/pesaing

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

Domain target

Example:ahrefs.com
scopestringrequired

Cakupan target.

Nilai yang diizinkan:urlpathdomainsubdomains
content_filterobject

Optional phrases used to include or exclude results based on their content.

includearray<string>

Only show results containing at least one of these exact phrases.

excludearray<string>

Hide results containing any of these exact phrases.

data_sourcearray<string>Required

Daftar model chatbot. 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
countryarray<string>

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

Nilai yang diizinkan:adaeafagaialamaoarasatauawazba…
Default:[]
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)Required

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

date_tostring (date)

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

search_volume_typestring

Laporan visibilitas AI beralih ke volume yang disesuaikan untuk AI. Ini memberikan estimasi permintaan yang lebih baik untuk respons AI di seluruh 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 yang disesuaikan untuk AI yang baru.

Nilai yang diizinkan:ask_volumekeyword_volume
Default:ask_volume
tags_filterobject

Ekspresi filter untuk tag prompt. Memerlukan report_id. Menggunakan sintaks filter dengan batasan berikut: satu-satunya nama field yang valid adalah "tag"; operator yang valid hanyalah: "eq", "neq", "substring", "isubstring", "phrase_match", "iphrase_match", "prefix", "suffix", "empty"; kedalaman nesting maksimum untuk and dan or adalah 2.

Example:{"or":[{"field":"tag","is":["eq","branded"]},{"field":"tag","is":["eq","competitor"]}]}
outputstring

Format output.

Nilai yang diizinkan:jsonphp

Respons

metricsarray<object>
datestring (date)
share_of_voicearray<object>

(1 unit per merek) Perkiraan pangsa suara untuk merek.

brandstring
share_of_voicenumber (float)