API цен на скины CS2: как получить цены всех маркетплейсов в своём коде

Если у вас торговый бот, Discord-бот, магазин скинов или таблица, рано или поздно понадобятся цены больше чем с одного маркетплейса. Парсинг каждого медленный, часто ломается и приводит к блокировкам. API цен даёт всё одним ответом.

Один запрос, все маркетплейсы

API цен API Skins возвращает самую низкую цену предмета на каждом из 22 маркетплейсов. Получите ключ на странице документации API после входа через Steam и отправляйте его в заголовке X-API-KEY:

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

В ответе перечислены все маркетплейсы, продающие предмет, с ценой в USD и временем последнего изменения:

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

Пакеты и весь рынок

Укажите несколько предметов, повторяя market_hash_name, или опустите параметр, чтобы получить все предметы сразу. Добавьте providers=cs_float,buff_163, чтобы получить только нужные маркетплейсы. Каждый запрос учитывается один раз в 30-дневном лимите, сколько бы предметов он ни вернул, поэтому одна полная загрузка в час — самый дешёвый способ держать локальную копию рынка.

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();

Лимиты

Бесплатный тариф включает 100 запросов каждые 30 дней к ценам и ордерам на покупку Steam, этого хватит для пробы. Платные подписки добавляют все остальные маркетплейсы и доходят до 100,000 запросов каждые 30 дней. Каждый запрос также учитывается в поминутном лимите; сверх него API отвечает 429 с заголовком Retry-After. Машиночитаемое описание всех маршрутов находится на /openapi.json.