Docs
Cari dokumen...⌘K

Halaman yang dikutip

API + MCP
POST/v3/brand-radar/cited-pages

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

selectarray<string>Required

Daftar kolom yang akan dikembalikan. Lihat schema respons untuk pengenal kolom yang valid.

Example:["field_a","field_b"]
whereobject

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

cited_domain: Domain halaman yang digunakan untuk menghasilkan respons.
tipe: domain

cited_domain_subdomains: Domain halaman yang digunakan untuk menghasilkan respons. Subdomain apa pun dari domain yang diberikan juga akan cocok.
tipe: string

cited_url_exact: URL halaman yang digunakan untuk menghasilkan respons.
tipe: string

cited_url_prefix: URL halaman yang digunakan untuk menghasilkan respons. URL apa pun yang diawali dengan prefiks ini akan cocok.
tipe: string

question: Pertanyaan yang diajukan oleh pengguna.
tipe: string

response (10 units): Respons dari model.
tipe: string

search_queries: Kueri penelusuran yang digunakan chatbot untuk menemukan informasi untuk respons. Catatan: jika data_source tidak menyertakan chatgpt atau perplexity, field ini akan selalu kosong.
tipe: string

topic: Topik kueri.
tipe: string

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"]}]}.

limitinteger

Jumlah hasil yang akan dikembalikan.

Default:1000
datestring

Tanggal yang akan dicari dalam format YYYY-MM-DD.

countryarray<string>

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

Allowed values:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
tracked_urlsarray<string>

Daftar URL halaman terlacak. Jika disediakan, respons menyertakan baris dengan nol sitasi untuk URL terlacak apa pun yang tidak memiliki data.

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.

Allowed values:ahrefscustom
data_sourcearray<string>Required

Daftar model chatbot. Model Google (google_ai_overviews, google_ai_mode) tidak dapat digabungkan satu sama lain atau dengan model non-Google.

Allowed values:google_ai_overviewsgoogle_ai_modechatgptgeminiperplexitycopilotgrok
marketarray<string>

Daftar pasar niche merek Anda.

competitorsarray<object>

Daftar nama kompetitor dan situs web yang akan dicari.

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

Nama merek/kompetitor

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstringrequired

Domain target

Example:ahrefs.com
scopestringrequired

Cakupan target.

Allowed values:urlpathdomainsubdomains
brandsarray<object>

Daftar nama merek dan situs web yang akan dicari.

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

Nama merek/kompetitor

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstringrequired

Domain target

Example:ahrefs.com
scopestringrequired

Cakupan target.

Allowed values:urlpathdomainsubdomains
outputstring

Format output.

Allowed values:jsonphp

Respons

pagesarray<object>
mentionsarray<object>

Tidak digunakan lagi pada 2026-02-10.

responsesinteger

Jumlah respons yang mengutip halaman tersebut.

urlstring

URL halaman yang dikutip.

volumeinteger

Tidak digunakan lagi pada 2026-03-24.