Publiczne API dla deweloperów

Darmowe API JSON tylko do odczytu z cenami przedmiotów CS2, wyceną ekwipunku Steam, drużynami i graczami pro. Działa bez klucza i rejestracji, CORS jest otwarty, ceny są w dolarach amerykańskich i odświeżają się mniej więcej co godzinę. Darmowy klucz z profilu podnosi limity.

Endpointy

Tabela powstaje z dokumentu OpenAPI; opisy są po angielsku. Parametry oznaczone * są wymagane.

Endpoint	Zwraca	Parametry
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*`

Limity

Bez klucza limity liczą się na adres IP; następna sekcja porównuje je z limitami osobistego klucza. Znani asystenci AI, rozpoznawani po User-Agent, mają własny poziom:

Zapytania na minutę dla znanych asystentów AI na /api/v1: 600
Wyceny ekwipunku na godzinę dla asystentów AI: 600
Zapytania na minutę o nigdy niewyceniane profile, wspólna pula wszystkich asystentów AI: 8

Po przekroczeniu limitu API odpowiada 429, a w trakcie liczenia świeżej wyceny 503; obie odpowiedzi mają Retry-After w sekundach. Odczekaj tyle i ponów zapytanie raz.

Wyższe limity z kluczem API

Wszystkie endpointy działają bez klucza. Z darmowym osobistym kluczem limity liczą się na klucz, a nie na adres IP, i są wyższe, a /api/v1/inventory czeka do 25 s na świeżą wycenę zamiast odpowiadać 503.

Limit	Bez klucza	Z kluczem
Zapytania na minutę	120	600
Wyceny ekwipunku na godzinę	60	300
Nigdy niewyceniane profile na minutę	w ramach limitu godzinowego	30
Profile w jednym wywołaniu /api/v1/inventories	50	200

Jak zdobyć klucz

Zaloguj się przez Steam i otwórz w profilu sekcję „Klucze API”. Przejdź do profilu
Klucze są dostępne dla kont, które mają co najmniej dobę. Możesz mieć do 3 aktywnych kluczy, każdy z nazwą mówiącą, do czego służy.
Klucz pokazujemy tylko raz, przy tworzeniu: przechowujemy wyłącznie jego hash. Zgubiony lub ujawniony klucz unieważnisz jednym kliknięciem i zastąpisz nowym.

Jak przekazać klucz

Przekaż klucz w nagłówku Authorization ze schematem Bearer albo w nagłówku X-Api-Key. Klucze są odczytywane tylko na /api/v1; nie umieszczaj ich w kodzie działającym w przeglądarce ani w publicznych repozytoriach.

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

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

Nagłówki odpowiedzi i błędy

Klucz z literówką, nieznany lub unieważniony nigdy nie jest ignorowany: zapytanie dostaje 401 z WWW-Authenticate zamiast limitów anonimowych. Klucz zablokowanego konta dostaje 403. Po przekroczeniu limitu odpowiedź to 429 z Retry-After.

Specyfikacja i pliki do odczytu maszynowego

/api/openapi.json specyfikacja OpenAPI 3.1: parametry, schematy odpowiedzi i błędy
/.well-known/openapi.json ta sama specyfikacja pod adresem well-known
/llms.txt przegląd serwisu ze wzorcami URL i przepisami API dla asystentów AI
/llms-full.txt wszystkie tekstowe poradniki po angielsku w jednym pliku Markdown
/llms-catalog.txt top 500 skinów według wartości rynkowej ofert w JSON Lines, odświeżane co godzinę
/.well-known/ai-catalog.json manifest możliwości dla agentów AI
Metodologia skąd biorą się ceny i jak są liczone

Licencja

Poradniki, teksty redakcyjne i własne dane pochodne serwisu (szacunki puli dropu, RTP skrzynek, indeksy, dzienne mediany, tabele wzorów, zestawienie llms-catalog.txt) są na licencji CC BY 4.0: podaj Skinory z linkiem do strony źródłowej.

Dane drużyn i graczy (/api/v1/teams, /api/v1/players) pochodzą z Liquipedii i są na licencji CC BY-SA 4.0: podaj Skinory z linkiem i udostępniaj przeróbki na tej samej licencji.

Katalog przedmiotów (nazwy, obrazy, rzadkości i kolekcje z plików gry przez zbiór danych CSGO-API) i ceny rynków to dane stron trzecich. Serwis nie deklaruje dla nich licencji; obowiązują warunki pierwotnych źródeł.

CC BY 4.0 ↗ · CC BY-SA 4.0 ↗

Jak cytować

Cytuj stronę jako „Skinory — tytuł strony, URL, data aktualizacji”, z kanonicznym URL i datą podaną na stronie, a gdy jej brak — datą odczytu. Podawaj ceny z walutą i czasem: zmieniają się.

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