Publiczne API dla deweloperów
Darmowe JSON API tylko do odczytu: ceny CS2, Dota 2, Rust i TF2, analityka i indeks rynku CS2, wyceny ekwipunków Steam z dostępnymi sumami według gier oraz drużyny i gracze CS2. Większość metod wymaga bezpłatnego osobistego klucza API, który zarazem podnosi limity; indeks rynku i odczyt floatu działają również bez niego. Obsługiwane parametry i dane wymieniono poniżej.
Twoje skiny. Ceny pod obserwacją.
Zapisuj przedmioty CS2, śledź zmiany cen i porównuj rynki bezpośrednio na Steam.
Dostęp do API i limity osobiste
Bez klucza
Indeks rynku i odczyt floatu działają bez logowania: 5 zapytań na minutę na adres IP. Ceny, oferty, stan danych, pula dropów, drużyny, gracze i ekwipunki wymagają klucza.
EndpointyZ kluczem
Bezpłatny klucz osobisty do skryptów i integracji. Otwiera dostęp do cen, ofert, stanu danych, puli dropów, drużyn, graczy i ekwipunków oraz zwiększa limity liczone oddzielnie dla każdego klucza.
Jak zdobyć klucz| Limit | Bez klucza | Z kluczem |
|---|---|---|
| Zapytania na minutę | 5 | 120 |
| Zapytania o ekwipunek na godzinę: pojedyncze i zbiorcze | Wymagany klucz | 240 |
| Pierwsze sprawdzenia ekwipunku na minutę | Wymagany klucz | 24 |
| Profile w jednym wywołaniu /api/ | Wymagany klucz | 100 |
| Zapytania do koordynatora gry na minutę w /api/ | 10 | 15 |
Godzinny limit ekwipunku obejmuje obie metody; partia liczy się jako jedno zapytanie. Pojedynczy ekwipunek zwrócony ze stale: true nie zużywa tego limitu. Pierwsze sprawdzenia dotyczą profili bez zapisanej wyceny.
Wszystkie klucze używane z jednego adresu IP mają wspólny limit, niezależnie od kont, do których należą: 240 zapytań na minutę, 480 zapytań o ekwipunek na godzinę, 48 pierwszych sprawdzeń i 30 zapytań do koordynatora gry na minutę.
Jak zdobyć klucz
- Zaloguj się przez Steam i otwórz w profilu sekcję „Klucze API”. Przejdź do profilu
- Twórz klucze 5 minut po rejestracji w Skinory. Każde konto może mieć do 3 aktywnych kluczy z własnymi nazwami.
- 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.
Nagłówki odpowiedzi i błędy
- X-RateLimit-Limit
- dozwolona liczba zapytań na minutę
- X-RateLimit-Remaining
- zapytania pozostałe w bieżącym oknie
- X-RateLimit-Reset
- sekundy do wyzerowania okna
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.
Przykładowe zapytania
Ceny z kluczem
curl -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/price?q=AK-47%20%7C%20Redline"Jeden ekwipunek z kluczem
Przekaż SteamID64, adres profilu lub nazwę niestandardową do /api/v1/inventory. Ekwipunek musi być publiczny. Zapytanie może czekać do 25 s, zwrócić zapisaną wycenę (stale: true) albo 503 z Retry-After. checkedAt wskazuje czas wyceny.
curl --include -H "Authorization: Bearer $SKINORY_API_KEY" \
"https://skinory.io/api/v1/inventory?steam=76561197960287930"Zapisane wyceny partiami
Podaj do 100 identyfikatorów SteamID64 lub adresów /profiles/, oddzielonych przecinkami. /api/v1/inventories odczytuje zapisane wyceny bez połączenia ze Steam. cached oznacza zapisaną wycenę, a unknown jej brak. Zleć wycenę przez /api/v1/inventory.
curl -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/inventories?steam=76561198132414056,76561197960287930"Wszystkie ceny TF2 jednym zapytaniem
curl --compressed -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/games/tf2/prices"429 oznacza osiągnięcie limitu API; 503 oznacza oczekiwanie na wycenę ekwipunku lub tymczasowe ograniczenie żądań przez Steam. Odczekaj cały czas podany w Retry-After w sekundach, nawet jeśli przekracza minutę, i nie ponawiaj równolegle żądań dla tego samego profilu.
Aktualność cen
Ceny w /api/v1/price, /api/v1/offers i w metodach Dota 2, Rust i TF2 pod /api/v1/games są opóźnione o co najmniej 6 godzin. Sprawdzaj pricedAt, snapshotAt i stale: to nie są ceny na żywo. Gdy brak gotowej opóźnionej migawki, API zwraca 503 z Retry-After. Wyceny ekwipunku mają własny czas checkedAt.
Endpointy
Metody i parametry pochodzą z OpenAPI. Parametry oznaczone * są wymagane. Pełne schematy odpowiedzi znajdują się w specyfikacji.
| Endpoint | Zwraca | Parametry |
|---|---|---|
GET /api/v1/droppool klucz API | Śledzona pula cotygodniowych dropów CS2 | — |
GET /api/v1/status klucz API | Czasy aktualizacji źródeł cen i zbiorów danych | — |
GET /api/v1/index | Aktualny indeks rynku CS2 i kapitalizacja według kategorii | lang |
GET /api/v1/index/history | Dzienna historia indeksu CS2 dla jednej kategorii | categorydayslang |
GET /api/v1/inventory klucz API | Wycena publicznego ekwipunku Steam: CS2, Dota 2, Rust i TF2 | steam*lang |
GET /api/v1/inventories klucz API | Zapisane wyceny do 100 ekwipunków Steam w jednym zapytaniu | steam*lang |
GET /api/v1/price klucz API | Wyszukiwanie przedmiotów CS2 po nazwie; ceny opóźnione o co najmniej 6 godzin | q*langcurrency |
GET /api/v1/price/history klucz API | Dzienna historia cen jednego przedmiotu CS2 | q*dayslang |
GET /api/v1/offers klucz API | Oferty rynków dla przedmiotu CS2, opóźnione o co najmniej 6 godzin | name*lang |
GET /api/v1/games/{game} klucz API | Katalog Dota 2, Rust lub TF2: filtry i źródła cen | game*lang |
GET /api/v1/games/{game}/items klucz API | Przedmioty Dota 2, Rust lub TF2; ceny opóźnione o co najmniej 6 godzin | game*qnameheroraritytypequalityslotcategoryitemclasssortpagelimitlang |
GET /api/v1/games/{game}/items/{slug} klucz API | Przedmiot Dota 2, Rust lub TF2 z ofertami rynków, opóźnionymi o co najmniej 6 godzin | game*slug*lang |
GET /api/v1/games/{game}/prices klucz API | Wszystkie ceny jednej gry w jednej odpowiedzi, opóźnione o co najmniej 6 godzin | game* |
GET /api/v1/float | Float, seed, naklejki i zawieszka przedmiotu CS2 z linku inspekcji | url*lang |
GET /api/v1/teams klucz API | Drużyny CS2 w oficjalnym rankingu Valve | region |
GET /api/v1/teams/{slug} klucz API | Profil drużyny: skład, trofea, mecze i historia rankingu | slug* |
GET /api/v1/players klucz API | Gracze drużyn z rankingu Valve | steamlimit |
GET /api/v1/players/{slug} klucz API | Profil gracza i aktualna drużyna | slug* |
Oddzielny dostęp dla asystentów AI
Rozpoznani asystenci AI mogą sprawdzać ekwipunki bez klucza. Limity zapytań obowiązują na IP; pierwsze sprawdzenia dzielą wspólny budżet wszystkich asystentów. Partia może zawierać do 50 profili. To nie są limity Twojego klucza osobistego.
- Zapytania na minutę dla znanych asystentów AI na /api/v1
- 120
- Zapytania o ekwipunek na godzinę na IP
- 120
- Zapytania na minutę o nigdy niewyceniane profile, wspólna pula wszystkich asystentów AI
- 16
Specyfikacja i pliki do odczytu maszynowego
/api/openapi.jsonspecyfikacja OpenAPI 3.1: parametry, schematy odpowiedzi i błędy/.well-known/openapi.jsonta sama specyfikacja pod adresem well-known/llms.txtprzegląd serwisu ze wzorcami URL i przepisami API dla asystentów AI/llms-full.txtwszystkie tekstowe poradniki po angielsku w jednym pliku Markdown/llms-catalog.txtCS2: top 500 skinów według wartości rynkowej ofert w JSON Lines, odświeżane co godzinę/.well-known/ai-catalog.jsonmanifest 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.
Katalogi korzystają z danych Steam i plików gier, w tym CSGO-API dla CS2. Te materiały i ceny platform pochodzą od stron trzecich; obowiązują warunki pierwotnych właścicieli praw.
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-11-11