API awam untuk pembangun

API JSON percuma baca sahaja dengan harga item CS2, penilaian inventori Steam, pasukan dan pemain pro. Berfungsi tanpa kunci atau pendaftaran, CORS terbuka, harga dalam dolar AS dan dikemas kini lebih kurang setiap jam. Kunci percuma daripada profil anda menaikkan had.

Endpoint

Jadual ini dibina daripada dokumen OpenAPI; penerangan dalam bahasa Inggeris. Parameter bertanda * adalah wajib.

Endpoint	Memulangkan	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*`

Had

Tanpa kunci, had dikira bagi setiap alamat IP; bahagian seterusnya membandingkannya dengan had kunci peribadi. Pembantu AI yang dikenali, dikesan melalui User-Agent, mempunyai peringkat sendiri:

Permintaan seminit untuk pembantu AI yang dikenali di /api/v1: 600
Penilaian inventori sejam untuk pembantu AI: 600
Carian seminit bagi profil yang belum pernah dinilai, dikongsi oleh semua pembantu AI: 8

Melebihi had, API menjawab 429, dan 503 semasa penilaian baharu sedang dikira; kedua-duanya membawa Retry-After dalam saat. Tunggu selama itu dan cuba sekali lagi.

Had lebih tinggi dengan kunci API

Semua endpoint berfungsi tanpa kunci. Dengan kunci peribadi percuma, had dikira bagi setiap kunci, bukan setiap alamat IP, dan lebih tinggi, manakala /api/v1/inventory menunggu penilaian baharu sehingga 25 saat dan tidak menjawab 503.

Had	Tanpa kunci	Dengan kunci
Permintaan seminit	120	600
Penilaian inventori sejam	60	300
Profil yang belum pernah dinilai seminit	dalam had sejam	30
Profil bagi setiap panggilan /api/v1/inventories	50	200

Cara mendapatkan kunci

Log masuk melalui Steam dan buka bahagian “Kunci API” dalam profil anda. Pergi ke profil
Kunci tersedia untuk akaun yang berusia sekurang-kurangnya sehari. Anda boleh menyimpan sehingga 3 kunci aktif, setiap satu dengan nama yang menerangkan kegunaannya.
Kunci hanya dipaparkan sekali, semasa dicipta: kami hanya menyimpan hash kunci itu. Kunci yang hilang atau terbocor boleh ditarik balik dengan satu klik dan diganti dengan yang baharu.

Cara menghantar kunci

Hantar kunci dalam pengepala Authorization dengan skema Bearer atau dalam pengepala X-Api-Key. Kunci hanya dibaca pada /api/v1; jangan letakkannya dalam kod pelayar atau repositori awam.

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"

Pengepala respons dan ralat

Kunci yang salah taip, tidak dikenali atau telah ditarik balik tidak pernah diabaikan: permintaan menerima 401 dengan WWW-Authenticate dan tidak beralih kepada had tanpa nama. Kunci akaun yang disekat menerima 403. Melebihi had, jawapannya ialah 429 dengan Retry-After.

Spesifikasi dan fail boleh baca mesin

/api/openapi.json spesifikasi OpenAPI 3.1: parameter, skema respons dan ralat
/.well-known/openapi.json spesifikasi yang sama di alamat well-known
/llms.txt gambaran keseluruhan laman dengan corak URL dan resipi API untuk pembantu AI
/llms-full.txt semua panduan teks bahasa Inggeris dalam satu fail Markdown
/llms-catalog.txt 500 skin teratas mengikut nilai pasaran senarai dalam JSON Lines, dikemas kini setiap jam
/.well-known/ai-catalog.json manifes keupayaan untuk ejen AI
Metodologi dari mana harga datang dan cara ia dikira

Lesen

Panduan, teks editorial dan data terbitan laman sendiri (anggaran drop pool, RTP case, indeks, median harian, jadual corak, kompilasi llms-catalog.txt) dilesenkan CC BY 4.0: nyatakan Skinory dengan pautan ke halaman sumber.

Data pasukan dan pemain (/api/v1/teams, /api/v1/players) diperoleh daripada Liquipedia dan dilesenkan CC BY-SA 4.0: nyatakan Skinory dengan pautan dan kongsi adaptasi di bawah lesen yang sama.

Katalog item (nama, imej, kejarangan dan koleksi daripada fail permainan melalui set data CSGO-API) dan harga pasaran ialah data pihak ketiga. Laman ini tidak mengisytiharkan lesen untuknya; syarat sumber asal terpakai.

CC BY 4.0 ↗ · CC BY-SA 4.0 ↗

Cara memetik

Petik halaman sebagai “Skinory — tajuk halaman, URL, tarikh kemas kini”, dengan URL kanonik dan tarikh yang ditunjukkan halaman, jika tiada tarikh anda membacanya. Nyatakan harga bersama mata wang dan masa: harga berubah.

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