Ikhtisar Pesaing

API + MCP

GET/v3/rank-tracker/competitors-overview

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. Pengidentifikasi kolom berikut dikenali (ini berbeda dari pengidentifikasi yang dikenali oleh parameter select).

selectstringWajib

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

date_comparedstring (date)

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

datestring (date)Wajib

Tanggal pelaporan 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: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).

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW

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.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found

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