API publik untuk developer

API JSON gratis yang hanya-baca dengan harga item CS2, penilaian inventaris Steam, tim dan pemain pro. Bisa dipakai tanpa kunci atau pendaftaran, CORS terbuka, harga dalam dolar AS dan diperbarui kira-kira setiap jam. Kunci gratis dari profilmu menaikkan batasnya.

Endpoint

Tabel ini dibuat dari dokumen OpenAPI; deskripsinya dalam bahasa Inggris. Parameter bertanda * wajib diisi.

Endpoint	Mengembalikan	Parameter
GET `/api/v1/inventory`	Appraise a public CS2 Steam inventory	`steam*lang`
GET `/api/v1/inventories`	Stored appraisals of up to 50 Steam inventories in one call (200 with an API key)	`steam*lang`
GET `/api/v1/price`	Find CS2 items by name and get their current prices	`q*lang`
GET `/api/v1/price/history`	Daily price history of one CS2 item	`q*dayslang`
GET `/api/v1/teams`	Top CS2 teams by the official Valve ranking	`region`
GET `/api/v1/teams/{slug}`	Team profile: roster, trophies, current events, recent matches, map stats and rank history	`slug*`
GET `/api/v1/players`	Players of the ranked teams, optionally only those with a public Steam profile	`steamlimit`
GET `/api/v1/players/{slug}`	Player of a ranked team	`slug*`

Batas

Tanpa kunci, batas dihitung per alamat IP; bagian berikutnya membandingkannya dengan batas kunci pribadi. Asisten AI yang dikenal, yang dikenali dari User-Agent-nya, punya tingkatan sendiri:

Permintaan per menit untuk asisten AI yang dikenal di /api/v1: 600
Penilaian inventaris per jam untuk asisten AI: 600
Pencarian per menit untuk profil yang belum pernah dinilai, dibagi oleh semua asisten AI: 8

Jika melewati batas, API menjawab 429, dan 503 selama penilaian baru sedang dihitung; keduanya membawa Retry-After dalam detik. Tunggu selama itu lalu coba lagi sekali.

Batas lebih tinggi dengan kunci API

Semua endpoint bisa dipakai tanpa kunci. Dengan kunci pribadi gratis, batas dihitung per kunci, bukan per alamat IP, dan lebih tinggi, sementara /api/v1/inventory menunggu penilaian baru hingga 25 dtk alih-alih menjawab 503.

Batas	Tanpa kunci	Dengan kunci
Permintaan per menit	120	600
Penilaian inventaris per jam	60	300
Profil yang belum pernah dinilai per menit	masuk batas per jam	30
Profil per panggilan /api/v1/inventories	50	200

Cara mendapatkan kunci

Masuk lewat Steam dan buka bagian “Kunci API” di profilmu. Buka profil
Kunci tersedia untuk akun yang berumur minimal satu hari. Kamu bisa punya hingga 3 kunci aktif, masing-masing dengan nama yang menjelaskan kegunaannya.
Kunci hanya ditampilkan sekali, saat dibuat: kami hanya menyimpan hash-nya. Kunci yang hilang atau bocor bisa dicabut dengan satu klik lalu diganti yang baru.

Cara mengirim kunci

Kirim kunci di header Authorization dengan skema Bearer atau di header X-Api-Key. Kunci hanya dibaca di /api/v1; jangan taruh di kode yang berjalan di browser atau di repositori publik.

curl -H "Authorization: Bearer $SKINORY_API_KEY" \
  "https://skinory.io/api/v1/price?q=AK-47%20%7C%20Redline"

curl -H "X-Api-Key: $SKINORY_API_KEY" \
  "https://skinory.io/api/v1/inventory?steam=76561197960287930"

Header respons dan galat

Kunci yang salah ketik, tidak dikenal, atau sudah dicabut tidak pernah diabaikan: permintaan mendapat 401 dengan WWW-Authenticate, bukan beralih ke batas anonim. Kunci milik akun yang diblokir mendapat 403. Di atas batas, jawabannya 429 dengan Retry-After.

Spesifikasi dan file yang dapat dibaca mesin

/api/openapi.json spesifikasi OpenAPI 3.1: parameter, skema respons, dan error
/.well-known/openapi.json spesifikasi yang sama di alamat well-known
/llms.txt ringkasan situs dengan pola URL dan resep API untuk asisten AI
/llms-full.txt semua panduan teks berbahasa Inggris dalam satu file Markdown
/llms-catalog.txt 500 skin teratas menurut nilai pasar listing dalam JSON Lines, diperbarui setiap jam
/.well-known/ai-catalog.json manifes kemampuan untuk agen AI
Metodologi dari mana harga berasal dan bagaimana dihitung

Lisensi

Panduan, teks editorial, dan data turunan milik situs sendiri (perkiraan drop pool, RTP case, indeks, median harian, tabel pola, kompilasi llms-catalog.txt) berlisensi CC BY 4.0: sebutkan Skinory dengan tautan ke halaman sumber.

Data tim dan pemain (/api/v1/teams, /api/v1/players) berasal dari Liquipedia dan berlisensi CC BY-SA 4.0: sebutkan Skinory dengan tautan dan bagikan adaptasi dengan lisensi yang sama.

Katalog item (nama, gambar, kelangkaan, dan koleksi dari file game melalui dataset CSGO-API) dan harga pasar adalah data pihak ketiga. Situs ini tidak menyatakan lisensi untuknya; ketentuan sumber aslinya berlaku.

CC BY 4.0 ↗ · CC BY-SA 4.0 ↗

Cara mengutip

Kutip halaman sebagai “Skinory — judul halaman, URL, tanggal pembaruan”, dengan URL kanonis dan tanggal yang ditampilkan halaman, atau tanggal Anda membacanya. Sertakan mata uang dan waktu pada harga: harga berubah.

Skinory — AK-47 | Redline, https://skinory.io/id/items/ak-47-redline, 2026-09-27