Відкритий API для розробників
Безкоштовний JSON API лише для читання: ціни CS2, Dota 2, Rust і TF2, аналітика та індекс ринку CS2, оцінка інвентарів Steam із доступними підсумками за іграми, команди й гравці CS2. Більшості ендпоінтів потрібен безкоштовний особистий API-ключ, який заразом підвищує ліміти; індекс ринку й перевірка флоату працюють і без нього. Підтримувані параметри та дані — нижче.
Твої скіни. Твої ціни під наглядом.
Зберігай предмети CS2, стеж за зміною цін і порівнюй пропозиції маркетів прямо в Steam.
Доступ до API та особисті ліміти
Без ключа
Індекс ринку й перевірка флоату працюють без входу: 5 запитів на хвилину з однієї IP-адреси. Для цін, пропозицій, статусу даних, пулу дропу, команд, гравців та інвентарів потрібен ключ.
ЕндпоінтиЗ ключем
Безкоштовний особистий ключ для твоїх скриптів та інтеграцій. Відкриває ціни, пропозиції, статус даних, пул дропу, команди, гравців та інвентарі й підвищує ліміти — їх рахують окремо для кожного ключа.
Як отримати ключ| Ліміт | Без ключа | З ключем |
|---|---|---|
| Запитів на хвилину | 5 | 120 |
| Запитів до інвентарів на годину: одиночних і пакетних | Потрібен ключ | 480 |
| Первинних перевірок інвентаря на хвилину | Потрібен ключ | 48 |
| Профілів в одному запиті /api/ | Потрібен ключ | 100 |
| Запитів до координатора гри на хвилину на /api/ | 10 | 15 |
Годинна квота інвентарів спільна для обох ендпоінтів; пакет рахується як один запит. Одиночний інвентар, повернений зі stale: true, цієї квоти не витрачає. Первинні перевірки — це запити до профілів, для яких ще немає збереженої оцінки.
Усі ключі, якими користуються з однієї IP-адреси, мають спільну стелю, хоч би яким акаунтам вони належали: 240 запитів на хвилину, 960 запитів до інвентарів на годину, 96 первинних перевірок і 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, посилання на профіль або його власну адресу (custom URL). Інвентар має бути публічним. Запит може чекати до 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 | Флоат, сід, наліпки та брелок предмета CS2 за inspect-посиланням | 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
- 240
- Запитів на хвилину до ще не оцінених профілів — спільний бюджет усіх ШІ-асистентів
- 32
Специфікація та машинозчитувані файли
/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/uk/items/ak-47-redline, 2026-11-13