Halaman Pesaing

API + MCP

GET/v3/rank-tracker/competitors-pages

Permintaan ke endpoint ini gratis dan tidak menghabiskan unit API.

Parameter kueri

timeoutinteger

Durasi batas waktu manual dalam detik.

limitinteger

Jumlah hasil yang akan dikembalikan.

Default:1000

order_bystring

Daftar kolom yang dipisahkan koma untuk mengurutkan hasil, dengan arah opsional. Lihat skema respons untuk pengenal kolom yang valid.

Example:field_a,field_b:asc,field_c:desc

wherestring

Ekspresi filter. Pengenal kolom berikut dikenali (ini berbeda dari pengenal yang dikenali oleh parameter select).

selectstringWajib

Daftar kolom yang akan dikembalikan, dipisahkan dengan koma. Lihat schema respons untuk pengenal kolom yang valid.

target_and_tracked_competitors_onlyboolean

Batasi halaman untuk target dan pesaing yang dilacak

Default:false

date_comparedstring (date)

Tanggal untuk membandingkan metrik dalam format YYYY-MM-DD.

datestring (date)Wajib

Tanggal untuk melaporkan metrik dalam format YYYY-MM-DD.

devicestringWajib

Pilih antara peringkat seluler dan desktop.

Nilai yang diizinkan:desktopmobile

project_idintegerWajib

Pengenal unik proyek. Anda dapat menemukannya di URL proyek Rank Tracker Anda di Ahrefs: https://app.ahrefs.com/rank-tracker/overview/#project_id#

volume_modestring

Mode perhitungan volume pencarian: bulanan atau rata-rata. Ini memengaruhi volume, traffic, dan nilai traffic.

Nilai yang diizinkan:monthlyaverage

Default:monthly

outputstring

Format output.

Nilai yang diizinkan:jsoncsvxmlphp

Respons

competitors-pagesarray<object>

keywordsinteger

Jumlah total kata kunci yang diperingkat target Anda di 100 hasil penelusuran organik teratas.

share_of_traffic_valuenumber (float)

Porsi nilai traffic pencarian organik target Anda dibandingkan dengan total nilai traffic pencarian organik untuk semua kata kunci yang dilacak.

share_of_traffic_value_prevnumber (float)

Pangsa Nilai Traffic pada tanggal perbandingan.

share_of_voicenumber (float)

Porsi traffic pencarian organik target Anda dibandingkan dengan total traffic pencarian organik untuk semua kata kunci yang dilacak.

share_of_voice_prevnumber (float)

Pangsa suara pada tanggal perbandingan.

statusstring

Status halaman: halaman baru yang baru mulai mendapatkan peringkat ("left"), halaman yang hilang dari hasil pencarian ("right"), atau tidak ada perubahan ("both").

Allowed values:leftrightboth

titlestring or null

Judul yang ditampilkan untuk halaman pada SERP Kata Kunci Teratasnya.

title_prevstring or null

Judul pada tanggal perbandingan.

trafficinteger

Perkiraan jumlah kunjungan bulanan yang diperoleh halaman dari pencarian organik.

traffic_previnteger

Traffic pada tanggal perbandingan.

traffic_valueinteger or null

Perkiraan nilai traffic penelusuran organik bulanan sebuah halaman, dalam sen USD.

traffic_value_previnteger or null

Nilai Traffic pada tanggal perbandingan.

urlstring (url)

URL halaman.