Ikhtisar

API + MCP

GET/v3/rank-tracker/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 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

overviewsarray<object>

best_position_has_thumbnailboolean or null

Posisi teratas (atau URL target, jika ditetapkan) memiliki thumbnail.

best_position_has_thumbnail_previousboolean or null

Posisi teratas (atau URL target, jika ditetapkan) memiliki thumbnail pada tanggal perbandingan.

best_position_has_video_previewboolean or null

Posisi teratas (atau URL target, jika ditetapkan) memiliki pratinjau video.

best_position_has_video_preview_previousboolean or null

Posisi teratas (atau URL target, jika ditetapkan) memiliki pratinjau video pada tanggal perbandingan.

best_position_kindstring or null

Jenis posisi teratas (atau URL target, jika ditetapkan): organik, berbayar, atau fitur SERP.

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shopping

best_position_kind_previousstring or null

Jenis posisi teratas (atau URL target, jika ditetapkan) pada tanggal perbandingan.

clicksinteger or null

Metrik Klik mengacu pada jumlah rata-rata klik bulanan pada hasil pencarian yang dilakukan orang saat mencari kata kunci target. Beberapa pencarian menghasilkan klik pada beberapa hasil, sementara yang lain mungkin tidak menghasilkan klik sama sekali.

clicks_per_searchnumber (float) or null

Klik Per Pencarian adalah rasio Klik terhadap Volume Pencarian Kata Kunci. Ini menunjukkan jumlah berbagai hasil pencarian yang mendapatkan klik, secara rata-rata, ketika orang mencari kata kunci target di negara tertentu.

cost_per_clickinteger or null

Biaya Per Klik menunjukkan harga rata-rata yang dibayar pengiklan untuk setiap klik iklan dalam hasil pencarian berbayar untuk kata kunci.

countrystring

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

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW

country_prevstring

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

created_atstring (date-time)

Tanggal ketika kata kunci ditambahkan ke proyek.

is_brandedboolean

Niat pengguna: bermerek. Pengguna mencari merek atau nama perusahaan tertentu.

is_commercialboolean

Niat pengguna: komersial. Pengguna membandingkan produk atau layanan sebelum mengambil keputusan pembelian.

is_informationalboolean

Niat pengguna: informasi. Pengguna mencari informasi atau jawaban untuk pertanyaan tertentu.

is_localboolean

Niat pengguna: lokal. Pengguna mencari informasi yang relevan dengan lokasi tertentu atau layanan terdekat.

is_navigationalboolean

Niat pengguna: navigasi. Pengguna sedang mencari situs web atau halaman web tertentu.

is_transactionalboolean

Niat pengguna: transaksional. Pengguna siap untuk menyelesaikan tindakan, sering kali pembelian.

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.

keyword_prevstring

Kata kunci yang membuat target Anda mendapatkan peringkat pada tanggal perbandingan.

languagestring

Bahasa SERP yang digunakan untuk melacak kata kunci tertentu.

language_prevstring

Bahasa SERP pada tanggal perbandingan.

locationstring

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

location_prevstring

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

parent_topicstring or null

Topik Induk menentukan apakah Anda bisa mendapatkan peringkat untuk kata kunci target Anda saat menargetkan topik yang lebih umum di halaman Anda. Untuk mengidentifikasi Topik Induk, kami mengambil halaman peringkat 1 untuk kata kunci Anda dan menemukan kata kunci yang paling bertanggung jawab mengirimkan sebagian besar traffic ke halaman tersebut.

positioninteger or null

Posisi teratas (atau URL target, jika ditetapkan) dalam pencarian organik.

position_diffinteger or null

Perubahan posisi teratas (atau URL target, jika ditetapkan) di antara tanggal yang dipilih.

position_previnteger or null

Posisi teratas (atau URL target, jika ditetapkan) pada tanggal perbandingan.

search_type_imagenumber (float) or null

Jenis pencarian Gambar menunjukkan persentase pencarian kata kunci untuk gambar, yang menyoroti minat pada konten visual.

search_type_newsnumber (float) or null

Jenis pencarian Berita menunjukkan persentase pencarian kata kunci untuk artikel berita.

search_type_videonumber (float) or null

Jenis pencarian Video menunjukkan persentase pencarian kata kunci untuk video, yang mencerminkan minat pada konten video.

search_type_webnumber (float) or null

Jenis pencarian Web menunjukkan persentase pencarian untuk kata kunci yang dilakukan untuk konten web umum, menunjukkan minat pada berbagai macam informasi.

serp_featuresarray<string>

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

serp_features_prevarray<string>

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

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.

tags_prevarray<string>

Daftar tag yang ditetapkan pada kata kunci tertentu pada tanggal perbandingan.

target_positions_countinteger

Jumlah URL target yang mendapatkan peringkat untuk sebuah kata kunci.

trafficinteger or null

Perkiraan jumlah kunjungan bulanan yang diterima sebuah halaman dari penelusuran organik selama bulan terakhir, atau selama 12 bulan data terbaru yang diketahui, tergantung pada parameter "volume_mode".

traffic_diffinteger or null

Perubahan lalu lintas antara tanggal yang Anda pilih.

traffic_previnteger or null

urlstring (url) or null

URL dengan peringkat teratas (atau URL target, jika disetel) di penelusuran organik.

url_prevstring (url) or null

URL dengan peringkat teratas (atau URL target, jika disetel) pada tanggal perbandingan.

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

volume_desktop_pctnumber (float) or null

Persentase dari total volume pencarian yang berasal dari perangkat desktop.

volume_mobile_pctnumber (float) or null

Persentase dari total volume pencarian yang berasal dari perangkat seluler.