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

country: Negara tempat kata kunci tertentu dilacak. Kode negara dua huruf (ISO 3166-1 alpha-2).
tipe: string
enum: "AD" "AE" "AF" "AG" "AI" "AL" "AM" "AO" "AQ" "AR" "AS" "AT" "AU" "AW" "AX" "AZ" "BA" "BB" "BD" "BE" "BF" "BG" "BH" "BI" "BJ" "BL" "BM" "BN" "BO" "BQ" "BR" "BS" "BT" "BV" "BW" "BY" "BZ" "CA" "CC" "CD" "CF" "CG" "CH" "CI" "CK" "CL" "CM" "CN" "CO" "CR" "CU" "CV" "CW" "CX" "CY" "CZ" "DE" "DJ" "DK" "DM" "DO" "DZ" "EC" "EE" "EG" "EH" "ER" "ES" "ET" "FI" "FJ" "FK" "FM" "FO" "FR" "GA" "GB" "GD" "GE" "GF" "GG" "GH" "GI" "GL" "GM" "GN" "GP" "GQ" "GR" "GS" "GT" "GU" "GW" "GY" "HK" "HM" "HN" "HR" "HT" "HU" "ID" "IE" "IL" "IM" "IN" "IO" "IQ" "IR" "IS" "IT" "JE" "JM" "JO" "JP" "KE" "KG" "KH" "KI" "KM" "KN" "KP" "KR" "KW" "KY" "KZ" "LA" "LB" "LC" "LI" "LK" "LR" "LS" "LT" "LU" "LV" "LY" "MA" "MC" "MD" "ME" "MF" "MG" "MH" "MK" "ML" "MM" "MN" "MO" "MP" "MQ" "MR" "MS" "MT" "MU" "MV" "MW" "MX" "MY" "MZ" "NA" "NC" "NE" "NF" "NG" "NI" "NL" "NO" "NP" "NR" "NU" "NZ" "OM" "OTHER" "PA" "PE" "PF" "PG" "PH" "PK" "PL" "PM" "PN" "PR" "PS" "PT" "PW" "PY" "QA" "RE" "RO" "RS" "RU" "RW" "SA" "SB" "SC" "SD" "SE" "SG" "SH" "SI" "SJ" "SK" "SL" "SM" "SN" "SO" "SR" "SS" "ST" "SV" "SX" "SY" "SZ" "TC" "TD" "TF" "TG" "TH" "TJ" "TK" "TL" "TM" "TN" "TO" "TR" "TT" "TV" "TW" "TZ" "UA" "UG" "UM" "US" "UY" "UZ" "VA" "VC" "VE" "VG" "VI" "VN" "VU" "WF" "WS" "YE" "YT" "ZA" "ZM" "ZW"

is_main_position: Mengecualikan posisi di AI Overview, Sitelinks, Top stories, Image packs, Videos, Discussions and forums, serta posting di X (Twitter).
tipe: boolean

is_main_position_prev: Mengecualikan posisi di AI Overview, Sitelinks, Top stories, Image packs, Videos, Discussions and forums, serta posting di X (Twitter) pada tanggal perbandingan.
tipe: boolean

keyword: Kata kunci yang menjadi peringkat target Anda.
tipe: string

keyword_difficulty: Perkiraan tingkat kesulitan untuk masuk peringkat 10 besar hasil penelusuran organik untuk sebuah kata kunci pada skala 100 poin.
tipe: integer nullable

keyword_has_data: Akan mengembalikan false jika kata kunci masih diproses dan SERP belum diambil.
tipe: boolean

keyword_is_frozen: Menunjukkan apakah sebuah kata kunci telah melampaui batas kata kunci yang dilacak pada paket Anda. Kata kunci tersebut "dibekukan", artinya peringkatnya tidak diperbarui.
tipe: boolean

language: Bahasa SERP yang digunakan untuk melacak kata kunci tertentu.
tipe: string

location: Lokasi (negara, negara bagian/provinsi, atau kota) tempat kata kunci tertentu dilacak.
tipe: string

serp_features: Fitur SERP yang muncul dalam hasil penelusuran untuk sebuah kata kunci.
tipe: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"

serp_updated: Tanggal saat kami terakhir memeriksa hasil mesin telusur untuk sebuah kata kunci.
tipe: datetime nullable

serp_updated_prev: Tanggal saat kami memeriksa hasil mesin telusur hingga tanggal perbandingan.
tipe: datetime nullable

tags: Daftar tag yang ditetapkan untuk sebuah kata kunci.
tipe: array(string)

volume: Perkiraan rata-rata jumlah penelusuran bulanan untuk sebuah kata kunci selama bulan terakhir atau selama 12 bulan data terakhir yang diketahui, tergantung pada parameter "volume_mode".
tipe: integer nullable

selectstringWajib

Daftar kolom yang dipisahkan koma untuk dikembalikan. Lihat skema respons untuk pengenal kolom yang valid.

date_comparedstring

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

datestringWajib

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: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 or null

Tanggal terakhir kami memeriksa hasil mesin pencari untuk kata kunci.

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