Pampublikong API para sa mga developer

Libreng read-only na JSON API na may presyo ng mga item sa CS2, pag-appraise ng Steam inventory, mga pro team at player. Gumagana nang walang key o sign-up, bukas ang CORS, nasa US dollar ang presyo at nag-a-update halos bawat oras. Tinataasan ng libreng key mula sa profile mo ang mga limit.

Mga endpoint

Binubuo ang talahanayan mula sa OpenAPI document; nasa Ingles ang mga paglalarawan. Kailangan ang mga parameter na may *.

Endpoint	Ibinabalik	Mga 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*`

Mga limitasyon

Kapag walang key, binibilang ang mga limit kada IP address; ikinukumpara ang mga ito sa susunod na seksyon sa mga limit ng personal na key. May sariling antas ang mga kilalang AI assistant na nakikilala sa kanilang User-Agent:

Request kada minuto para sa kilalang AI assistant sa /api/v1: 600
Inventory appraisal kada oras para sa AI assistant: 600
Lookup kada minuto ng mga profile na hindi pa na-appraise, hati-hati ng lahat ng AI assistant: 8

Kapag lampas sa limit, sasagot ang API ng 429, at 503 habang kinakalkula ang bagong appraisal; parehong may Retry-After sa segundo. Maghintay nang ganoon katagal at subukang muli nang isang beses.

Mas mataas na limit gamit ang API key

Gumagana ang lahat ng endpoint kahit walang key. Sa libreng personal na key, binibilang ang mga limit kada key sa halip na kada IP address at mas mataas ang mga ito, at naghihintay ang /api/v1/inventory nang hanggang 25 s para sa bagong appraisal sa halip na sumagot ng 503.

Limit	Walang key	May key
Request kada minuto	120	600
Inventory appraisal kada oras	60	300
Hindi pa na-appraise na profile kada minuto	saklaw ng limit kada oras	30
Profile kada tawag sa /api/v1/inventories	50	200

Paano makakuha ng key

Mag-sign in gamit ang Steam at buksan ang seksyong “Mga API key” sa profile mo. Pumunta sa profile
Para sa mga account na hindi bababa sa isang araw ang edad ang mga key. Puwede kang magkaroon ng hanggang 3 aktibong key, bawat isa may pangalang nagsasabi kung para saan ito.
Isang beses lang ipinapakita ang key, kapag ginawa ito: hash lang nito ang itinatago namin. Ang nawala o na-leak na key ay nire-revoke sa isang click at pinapalitan ng bago.

Paano ipadala ang key

Ipadala ang key sa header na Authorization gamit ang scheme na Bearer o sa header na X-Api-Key. Sa /api/v1 lang binabasa ang mga key; huwag itong ilagay sa code na tumatakbo sa browser o sa mga public repository.

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"

Mga response header at error

Hindi kailanman binabalewala ang key na mali ang pagkaka-type, hindi kilala o na-revoke na: 401 na may WWW-Authenticate ang matatanggap ng request sa halip na bumalik sa anonymous na limit. 403 naman ang key ng account na naka-ban. Kapag lampas sa limit, 429 na may Retry-After ang sagot.

Spesipikasyon at mga machine-readable na file

/api/openapi.json OpenAPI 3.1 na spesipikasyon: mga parameter, schema ng tugon at error
/.well-known/openapi.json parehong spesipikasyon sa well-known na address
/llms.txt overview ng site na may URL pattern at API recipe para sa mga AI assistant
/llms-full.txt lahat ng gabay na teksto sa Ingles sa iisang Markdown file
/llms-catalog.txt nangungunang 500 skin ayon sa nakalistang market value bilang JSON Lines, ina-update bawat oras
/.well-known/ai-catalog.json capability manifest para sa mga AI agent
Metodolohiya saan galing ang mga presyo at paano kinakalkula

Lisensya

Ang mga gabay, editoryal na teksto at sariling derived data ng site (tantiya ng drop pool, RTP ng case, mga index, pang-araw-araw na median, mga table ng pattern, ang compilation na llms-catalog.txt) ay nasa lisensyang CC BY 4.0: banggitin ang Skinory na may link sa pinagmulang pahina.

Ang data ng mga team at player (/api/v1/teams, /api/v1/players) ay mula sa Liquipedia at nasa lisensyang CC BY-SA 4.0: banggitin ang Skinory na may link at ibahagi ang mga adaptation sa parehong lisensya.

Ang katalogo ng item (mga pangalan, larawan, rarity at koleksyon mula sa mga file ng laro sa pamamagitan ng CSGO-API dataset) at ang mga presyo ng market ay third-party data. Walang idinedeklarang lisensya ang site para sa mga ito; ang mga tuntunin ng orihinal na pinagmulan ang umiiral.

CC BY 4.0 ↗ · CC BY-SA 4.0 ↗

Paano mag-cite

I-cite ang pahina bilang “Skinory — pamagat ng pahina, URL, petsa ng update”, gamit ang canonical URL at ang petsang ipinapakita ng pahina, o ang petsang binasa mo ito. Isama ang currency at oras sa mga presyo: nagbabago ang mga ito.

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