API цен CS2 (КС2): эндпоинты, лимиты и лицензия — Skinory
ru ru
$ usd

Открытый API для разработчиков

Бесплатный JSON API только для чтения: цены предметов CS2, оценка инвентаря Steam, про-команды и игроки. Работает без ключа и регистрации, CORS открыт, цены в долларах США обновляются примерно раз в час. Бесплатный ключ из профиля поднимает лимиты.

Эндпоинты

Таблица собрана из документа OpenAPI, описания эндпоинтов — на английском. Параметры со звёздочкой * обязательны.

ЭндпоинтЧто возвращаетПараметры
GET /api/v1/inventoryAppraise a public CS2 Steam inventorysteam*lang
GET /api/v1/inventoriesStored appraisals of up to 50 Steam inventories in one call (200 with an API key)steam*lang
GET /api/v1/priceFind CS2 items by name and get their current pricesq*lang
GET /api/v1/price/historyDaily price history of one CS2 itemq*dayslang
GET /api/v1/teamsTop CS2 teams by the official Valve rankingregion
GET /api/v1/teams/{slug}Team profile: roster, trophies, current events, recent matches, map stats and rank historyslug*
GET /api/v1/playersPlayers of the ranked teams, optionally only those with a public Steam profilesteamlimit
GET /api/v1/players/{slug}Player of a ranked teamslug*

Лимиты

Без ключа лимиты считаются по IP-адресу; в следующем разделе они сравниваются с лимитами личного ключа. Для известных ИИ-ассистентов, которых мы узнаём по User-Agent, действует отдельный уровень:

Запросов в минуту для известных ИИ-ассистентов на /api/v1
600
Оценок инвентаря в час для ИИ-ассистентов
600
Запросов в минуту по ещё не оценённым профилям — общий бюджет всех ИИ-ассистентов
8

Сверх лимита API отвечает 429, а пока считается свежая оценка — 503; в обоих ответах есть Retry-After в секундах. Подождите это время и повторите запрос один раз.

Повышенные лимиты с API-ключом

Все эндпоинты работают без ключа. С бесплатным личным ключом лимиты считаются по ключу, а не по IP-адресу, и становятся выше, а /api/v1/inventory ждёт свежую оценку до 25 с вместо ответа 503.

ЛимитБез ключаС ключом
Запросов в минуту120600
Оценок инвентаря в час60300
Ещё не оценённых профилей в минутув рамках часового лимита30
Профилей в одном запросе /api/v1/inventories50200

Как получить ключ

  • Войдите через Steam и откройте в профиле раздел «API-ключи». Перейти в профиль
  • Ключи доступны аккаунтам старше суток. Одновременно можно держать до 3 активных ключей, у каждого — подпись, для чего он.
  • Ключ показывается один раз, при создании: мы храним только его хеш. Потерянный или утёкший ключ отзывается в один клик и заменяется новым.

Как передать ключ

Передайте ключ в заголовке Authorization со схемой Bearer или в заголовке X-Api-Key. Ключ читается только на /api/v1; не вставляйте его в код для браузера и в публичные репозитории.

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"

Заголовки ответа и ошибки

X-RateLimit-Limit
сколько запросов в минуту разрешено этому ключу
X-RateLimit-Remaining
сколько запросов осталось в текущем окне
X-RateLimit-Reset
через сколько секунд окно обнулится

Ключ с опечаткой, неизвестный или отозванный не игнорируется: запрос получает 401 с WWW-Authenticate, а не анонимные лимиты. Ключ заблокированного аккаунта получает 403. Сверх лимита ответ — 429 с Retry-After.

Спецификация и машиночитаемые файлы

  • /api/openapi.json спецификация OpenAPI 3.1: параметры, схемы ответов и ошибки
  • /.well-known/openapi.json та же спецификация по стандартному адресу well-known
  • /llms.txt обзор сайта с шаблонами URL и рецептами API для ИИ-ассистентов
  • /llms-full.txt все текстовые гайды на английском в одном файле Markdown
  • /llms-catalog.txt топ-500 скинов по рыночной стоимости лотов в формате JSON Lines, обновляется раз в час
  • /.well-known/ai-catalog.json манифест возможностей для ИИ-агентов
  • Методология откуда берутся цены и как они считаются

Лицензия

Гайды, редакционные тексты и собственные производные данные сайта (оценки дроп-пула, RTP кейсов, индексы, дневные медианы, таблицы паттернов, подборка llms-catalog.txt) распространяются по лицензии CC BY 4.0: укажите Skinory и дайте ссылку на исходную страницу.

Данные команд и игроков (/api/v1/teams, /api/v1/players) основаны на Liquipedia и распространяются по лицензии CC BY-SA 4.0: укажите Skinory со ссылкой и публикуйте переработки под той же лицензией.

Каталог предметов (названия, изображения, редкости и коллекции из файлов игры через датасет CSGO-API) и цены площадок — сторонние данные. Сайт не заявляет на них лицензию; действуют условия исходных источников.

CC BY 4.0 ↗ · CC BY-SA 4.0 ↗

Как цитировать

Ссылайтесь на страницу так: «Skinory — заголовок страницы, URL, дата обновления». Берите канонический URL и дату со страницы, а если её нет — дату, когда вы читали страницу. Цены указывайте с валютой и временем: они меняются.

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