Открытый API для разработчиков
Бесплатный JSON API только для чтения: цены CS2, Dota 2, Rust и TF2, аналитика и индекс рынка CS2, оценка инвентарей Steam с доступными итогами по играм, команды и игроки CS2. Большинству эндпоинтов нужен бесплатный личный API-ключ, который заодно поднимает лимиты; индекс рынка и проверка float работают и без него. Поддерживаемые параметры и данные перечислены ниже.
Расширение для браузера: цены на скины CS2
Сохраняйте предметы CS2, следите за изменением цен и сравнивайте предложения маркетов прямо в Steam.
Доступ к API и личные лимиты
Без ключа
Индекс рынка и проверка float работают без регистрации: 5 запросов в минуту на IP-адрес. Для цен, предложений, статуса данных, дроп-пула, команд, игроков и инвентарей нужен ключ.
ЭндпоинтыС ключом
Бесплатный личный ключ для ваших скриптов и приложений. Открывает доступ к ценам, предложениям, статусу данных, дроп-пулу, командам, игрокам и инвентарям, а также повышает лимиты: они считаются отдельно для каждого ключа.
Как получить ключ| Лимит | Без ключа | С ключом |
|---|---|---|
| Запросов в минуту | 5 | 120 |
| Запросов к инвентарям в час: одиночных и пакетных | Нужен ключ | 240 |
| Первичных проверок инвентаря в минуту | Нужен ключ | 24 |
| Профилей в одном запросе /api/ | Нужен ключ | 100 |
| Запросов к координатору игры в минуту на /api/ | 10 | 15 |
Часовая квота инвентаря общая для обоих методов; пакет считается одним запросом. Ответ одиночного метода с stale: true не расходует эту квоту. Первичные проверки — запросы по профилям, для которых ещё нет сохранённой оценки.
Все ключи, которыми пользуются с одного IP-адреса, делят общий потолок, сколько бы аккаунтов за ними ни стояло: 240 запросов в минуту, 480 запросов к инвентарям в час, 48 первичных проверок и 30 запросов к координатору игры в минуту.
Как получить ключ
- Войдите через Steam и откройте в профиле раздел «API-ключи». Перейти в профиль
- Ключи можно создавать через 5 минут после регистрации в Skinory. У аккаунта может быть до 3 активных ключей, каждый со своим названием.
- Ключ показывается один раз, при создании: мы храним только его хеш. Потерянный или утёкший ключ отзывается в один клик и заменяется новым.
Как передать ключ
Передайте ключ в заголовке Authorization со схемой Bearer или в заголовке X-Api-Key. Ключ читается только на /api/v1; не вставляйте его в код для браузера и в публичные репозитории.
Заголовки ответа и ошибки
- X-RateLimit-Limit
- разрешённое число запросов в минуту
- X-RateLimit-Remaining
- сколько запросов осталось в текущем окне
- X-RateLimit-Reset
- через сколько секунд окно обнулится
Ключ с опечаткой, неизвестный или отозванный не игнорируется: запрос получает 401 с WWW-Authenticate, а не анонимные лимиты. Ключ заблокированного аккаунта получает 403. Сверх лимита ответ — 429 с Retry-After.
Примеры запросов
Цены с ключом
curl -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/price?q=AK-47%20%7C%20Redline"Один инвентарь с ключом
Передайте в /api/v1/inventory SteamID64, ссылку на профиль или его короткое имя. Инвентарь должен быть публичным. Запрос может ждать до 25 с, вернуть сохранённую оценку (stale: true) или ответить 503 с Retry-After. Время оценки указано в checkedAt.
curl --include -H "Authorization: Bearer $SKINORY_API_KEY" \
"https://skinory.io/api/v1/inventory?steam=76561197960287930"Сохранённые оценки пакетом
Передайте до 100 SteamID64 или ссылок /profiles/ через запятую. /api/v1/inventories читает сохранённые оценки и не обращается к Steam. Статус cached означает готовую оценку, unknown — её отсутствие. Для запроса оценки используйте /api/v1/inventory.
curl -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/inventories?steam=76561198132414056,76561197960287930"Все цены TF2 одним запросом
curl --compressed -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/games/tf2/prices"429 означает достижение лимита API, а 503 — ожидание оценки инвентаря или временное ограничение Steam. Выждите полное время Retry-After в секундах, даже если оно больше минуты, и не запускайте параллельные повторы для одного профиля.
Свежесть цен
Цены в /api/v1/price, /api/v1/offers и в методах Dota 2, Rust и TF2 под /api/v1/games задержаны минимум на 6 часов. Проверяйте pricedAt, snapshotAt и stale: это не котировки в реальном времени. Пока готового задержанного снимка нет, API отвечает 503 с Retry-After. У оценки инвентаря своё время checkedAt.
Эндпоинты
Методы и параметры взяты из OpenAPI. Параметры со звёздочкой * обязательны. Полные схемы ответов — в спецификации.
| Эндпоинт | Что возвращает | Параметры |
|---|---|---|
GET /api/v1/droppool API-ключ | Отслеживаемый еженедельный дроп-пул CS2 | — |
GET /api/v1/status API-ключ | Время обновления ценовых фидов и наборов данных | — |
GET /api/v1/index | Текущий индекс рынка CS2 и капитализация по категориям | lang |
GET /api/v1/index/history | Дневная история индекса рынка CS2 для одной категории | categorydayslang |
GET /api/v1/inventory API-ключ | Оценка публичного инвентаря Steam: CS2, Dota 2, Rust и TF2 | steam*lang |
GET /api/v1/inventories API-ключ | Сохранённые оценки до 100 инвентарей Steam за запрос | steam*lang |
GET /api/v1/price API-ключ | Поиск предметов CS2 по имени; цены с задержкой минимум 6 часов | q*langcurrency |
GET /api/v1/price/history API-ключ | Дневная история цен одного предмета CS2 | q*dayslang |
GET /api/v1/offers API-ключ | Предложения маркетов для предмета CS2 с задержкой минимум 6 часов | name*lang |
GET /api/v1/games/{game} API-ключ | Каталог Dota 2, Rust или TF2: фильтры и источники цен | game*lang |
GET /api/v1/games/{game}/items API-ключ | Предметы Dota 2, Rust или TF2; цены с задержкой минимум 6 часов | game*qnameheroraritytypequalityslotcategoryitemclasssortpagelimitlang |
GET /api/v1/games/{game}/items/{slug} API-ключ | Предмет Dota 2, Rust или TF2 с предложениями маркетов, задержка минимум 6 часов | game*slug*lang |
GET /api/v1/games/{game}/prices API-ключ | Все цены одной игры одним ответом, задержка минимум 6 часов | game* |
GET /api/v1/float | Float, seed, наклейки и брелок предмета CS2 по ссылке осмотра | url*lang |
GET /api/v1/teams API-ключ | Команды CS2 в официальном рейтинге Valve | region |
GET /api/v1/teams/{slug} API-ключ | Профиль команды: состав, трофеи, матчи и история рейтинга | slug* |
GET /api/v1/players API-ключ | Игроки команд из рейтинга Valve | steamlimit |
GET /api/v1/players/{slug} API-ключ | Профиль игрока и текущая команда | slug* |
Отдельный доступ для ИИ-ассистентов
Известные ИИ-ассистенты могут обращаться к инвентарям без ключа. Квоты запросов считаются на IP; первичные проверки делят общий бюджет всех ассистентов. В пакете — до 50 профилей. Это не лимиты вашего личного ключа.
- Запросов в минуту для известных ИИ-ассистентов на /api/v1
- 120
- Запросов к инвентарям в час на IP
- 120
- Запросов в минуту по ещё не оценённым профилям — общий бюджет всех ИИ-ассистентов
- 16
Спецификация и машиночитаемые файлы
/api/openapi.jsonспецификация OpenAPI 3.1: параметры, схемы ответов и ошибки/.well-known/openapi.jsonта же спецификация по стандартному адресу well-known/llms.txtобзор сайта с шаблонами URL и рецептами API для ИИ-ассистентов/llms-full.txtвсе текстовые гайды на английском в одном файле Markdown/llms-catalog.txtCS2: топ-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 со ссылкой и публикуйте переработки под той же лицензией.
Каталоги предметов используют данные Steam и игровых файлов, включая CSGO-API для CS2. Эти материалы и цены маркетов принадлежат сторонним источникам; действуют условия их правообладателей.
Как цитировать
Ссылайтесь на страницу так: «Skinory — заголовок страницы, URL, дата обновления». Берите канонический URL и дату со страницы, а если её нет — дату, когда вы читали страницу. Цены указывайте с валютой и временем: они меняются.
Skinory — AK-47 | Redline, https://skinory.io/ru/items/ak-47-redline, 2026-11-11