API cen skinów CS2: jak pobrać ceny ze wszystkich marketplace'ów do swojego kodu

Jeśli prowadzisz bota handlowego, bota Discord, sklep ze skinami lub arkusz, prędzej czy później potrzebujesz cen z więcej niż jednego marketplace'u. Scrapowanie każdego jest wolne, często się psuje i kończy blokadą. API cen daje wszystko w jednej odpowiedzi.

Jedno żądanie, wszystkie marketplace'y

API cen API Skins zwraca najniższą cenę przedmiotu na każdym z 22 marketplace'ów. Zdobądź klucz na stronie dokumentacji API po zalogowaniu przez Steam i wysyłaj go w nagłówku X-API-KEY:

curl -H "X-API-KEY: ask_..." \
  "https://api.apiskins.com/v1/offers/AK-47%20%7C%20Redline%20(Field-Tested)"

Odpowiedź wymienia każdy marketplace sprzedający przedmiot, z ceną w USD i czasem ostatniej zmiany:

{
  "market_hash_name": "AK-47 | Redline (Field-Tested)",
  "offers": [
    { "provider": "buff_163", "price": 31.42 },
    { "provider": "cs_float", "price": 33.1 }
  ]
}

Paczki i cały rynek

Podaj kilka przedmiotów, powtarzając market_hash_name, lub pomiń ten parametr, by dostać wszystkie naraz. Dodaj providers=cs_float,buff_163, by dostać tylko wybrane marketplace'y. Każde żądanie liczy się raz do limitu 30-dniowego, niezależnie od liczby przedmiotów, więc jedno pełne pobranie na godzinę to najtańszy sposób na lokalną kopię rynku.

const response = await fetch("https://api.apiskins.com/v1/offers?providers=cs_float,buff_163", {
    headers: { "X-API-KEY": process.env.API_SKINS_KEY! },
});

const items: { market_hash_name: string; offers: { provider: string; price: number }[] }[] = await response.json();

Limity

Darmowy plan obejmuje 100 zapytań co 30 dni o ceny i zlecenia kupna Steam, wystarczy na próbę. Płatne subskrypcje dodają wszystkie pozostałe marketplace'y i sięgają 100,000 zapytań co 30 dni. Każde żądanie liczy się też do limitu minutowego; ponad niego API odpowiada 429 z nagłówkiem Retry-After. Czytelny maszynowo opis każdej trasy jest pod /openapi.json.