Открытый API для разработчиков
Бесплатный JSON API только для чтения: цены предметов CS2, оценка инвентаря Steam, про-команды и игроки. Работает без ключа и регистрации, CORS открыт, цены в долларах США обновляются примерно раз в час. Бесплатный ключ из профиля поднимает лимиты.
Эндпоинты
Таблица собрана из документа OpenAPI, описания эндпоинтов — на английском. Параметры со звёздочкой * обязательны.
| Эндпоинт | Что возвращает | Параметры |
|---|---|---|
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* |
Лимиты
Без ключа лимиты считаются по IP-адресу; в следующем разделе они сравниваются с лимитами личного ключа. Для известных ИИ-ассистентов, которых мы узнаём по User-Agent, действует отдельный уровень:
- Запросов в минуту для известных ИИ-ассистентов на /api/v1
- 600
- Оценок инвентаря в час для ИИ-ассистентов
- 600
- Запросов в минуту по ещё не оценённым профилям — общий бюджет всех ИИ-ассистентов
- 8
Сверх лимита API отвечает 429, а пока считается свежая оценка — 503; в обоих ответах есть Retry-After в секундах. Подождите это время и повторите запрос один раз.
Повышенные лимиты с API-ключом
Все эндпоинты работают без ключа. С бесплатным личным ключом лимиты считаются по ключу, а не по IP-адресу, и становятся выше, а /api/v1/inventory ждёт свежую оценку до 25 с вместо ответа 503.
| Лимит | Без ключа | С ключом |
|---|---|---|
| Запросов в минуту | 120 | 600 |
| Оценок инвентаря в час | 60 | 300 |
| Ещё не оценённых профилей в минуту | в рамках часового лимита | 30 |
| Профилей в одном запросе /api/ | 50 | 200 |
Как получить ключ
- Войдите через 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) и цены площадок — сторонние данные. Сайт не заявляет на них лицензию; действуют условия исходных источников.
Как цитировать
Ссылайтесь на страницу так: «Skinory — заголовок страницы, URL, дата обновления». Берите канонический URL и дату со страницы, а если её нет — дату, когда вы читали страницу. Цены указывайте с валютой и временем: они меняются.
Skinory — AK-47 | Redline, https://skinory.io/ru/items/ak-47-redline, 2026-09-27