Ikhtisar Pesaing

API + MCP

GET/v3/rank-tracker/competitors-overview

Permintaan ke endpoint ini gratis dan tidak menghabiskan unit API.

Parameter kueri

selectstringWajib

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

wherestring

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

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

limitinteger

Jumlah hasil yang akan dikembalikan.

Default:1000

timeoutinteger

Durasi batas waktu manual dalam detik.

volume_modestring

Mode perhitungan Volume Pencarian: bulanan atau rata-rata. Mode ini memengaruhi volume, traffic, dan Traffic Value.

Nilai yang diizinkan:monthlyaverage

Default:monthly

project_idintegerWajib

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

devicestringWajib

Pilih antara peringkat seluler dan desktop.

Nilai yang diizinkan:desktopmobile

datestring (date)Wajib

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

date_comparedstring (date)

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

outputstring

Format output.

Nilai yang diizinkan:jsonphp

Respons

keywordsarray<object>

competitors_listarray<object>

Informasi kompetitor untuk kata kunci tertentu. Kolom berikut disertakan: url, url_prev, position, position_prev, best_position_kind, best_position_kind_prev, traffic, traffic_prev, value, value_prev. Kolom yang diakhiri dengan prev hanya disertakan dalam tampilan perbandingan.

countrystring

Negara tempat kata kunci tertentu sedang dilacak. Kode negara dua huruf (ISO 3166-1 alpha-2).

Nilai yang diizinkan:ADAEAFAGAIALAMAOAQARASATAUAWAX…

keywordstring

Kata kunci yang membuat target Anda mendapatkan peringkat.

keyword_difficultyinteger or null

Perkiraan seberapa sulitnya untuk mendapatkan peringkat di 10 hasil pencarian organik teratas untuk sebuah kata kunci pada skala 100 poin.

keyword_has_databoolean

Akan mengembalikan false jika kata kunci masih diproses dan belum ada SERP yang diambil.

keyword_is_frozenboolean

Menunjukkan apakah sebuah kata kunci telah melampaui batas kata kunci yang dilacak pada paket Anda. Kata kunci seperti itu "dibekukan", artinya peringkatnya tidak diperbarui.

languagestring

Bahasa SERP yang digunakan untuk melacak kata kunci tertentu.

locationstring

Lokasi (negara, negara bagian/provinsi, atau kota) tempat kata kunci tertentu sedang dilacak.

serp_featuresarray<string>

Fitur SERP yang muncul dalam hasil pencarian untuk sebuah kata kunci.

Nilai yang diizinkan:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…

serp_updatedstring (date-time) or null

Tanggal terakhir kami memeriksa hasil mesin pencari untuk kata kunci.

serp_updated_prevstring (date-time) or null

Tanggal ketika kami memeriksa hasil mesin pencari hingga tanggal perbandingan.

tagsarray<string>

Daftar tag yang ditetapkan pada kata kunci tertentu.

volumeinteger or null

Perkiraan rata-rata jumlah pencarian bulanan untuk sebuah kata kunci selama bulan terakhir, atau selama 12 bulan data terbaru yang diketahui, tergantung pada parameter "volume_mode".