API для розробників
Безкоштовний публічний фід цін на скіни CS2 (CS:GO) у SkinCash. Створений для сайтів порівняння цін, агрегаторів і браузерних розширень. Без API-ключа, без реєстрації — лише простий GET-запит.
# приклад відповіді — натисніть Виконати, щоб звернутися до живого API
{
"currency": "USD",
"updated_at": "2026-08-05T12:00:00.000Z",
"count": 25812,
"items": [
{
"market_hash_name": "AK-47 | Redline (Field-Tested)",
"price": 14.50,
"quantity": 12,
"item_page": "https://skincash.gg/en/market/item/ak-47-redline-field-tested"
}
], …
}Стисло
Швидкий старт
Отримайте весь живий каталог одним запитом. Надсилайте Accept-Encoding: gzip (у curl — --compressed) — повний фід у розпакованому вигляді займає кілька МБ.
curl -s --compressed https://api.skincash.gg/v1/pricesОбрана вами мова зберігається на всій сторінці.
Автентифікація
API публічний — кожен ендпоінт це звичайний GET, без реєстрації, без OAuth. CORS відкритий, тож ви можете викликати його прямо з браузера. Просто надішліть запит:
Анонімний доступ обмежено за IP (див. Ліміти запитів). Якщо ви керуєте агрегатором чи розширенням і вам потрібно більше, ми видаємо безкоштовний партнерський ключ, який підвищує ваш ліміт — жодна інша поведінка не змінюється. Надсилайте його в заголовку Authorization: Bearer (або X-API-Key):
curl -s --compressed \
-H "Authorization: Bearer YOUR_API_KEY" \
https://api.skincash.gg/v1/pricesЗапросіть ключ на [email protected]. Тримайте його на боці сервера; ставтеся до нього як до пароля.
Ендпоінти
Повний каталог — кожен товар у продажу, найнижча ціна купівлі + живий залишок + пряме посилання, відсортовано від найдорожчого. Підтримує gzip і умовні запити. Спробувати вживу ↑
curl -s --compressed https://api.skincash.gg/v1/prices{
"currency": "USD",
"updated_at": "2026-08-05T12:00:00.000Z",
"count": 25812,
"items": [
{
"market_hash_name": "AK-47 | Redline (Field-Tested)",
"price": 14.50,
"quantity": 12,
"item_page": "https://skincash.gg/en/market/item/ak-47-redline-field-tested"
}
]
}Один товар за його точною назвою у Steam (URL-кодованою). Повертає 404, якщо він наразі не у продажу.
market_hash_nameрядок · обов’язковийТочна назва market_hash_name у Steam, URL-кодована.curl -s --compressed \
"https://api.skincash.gg/v1/prices/AK-47%20%7C%20Redline%20(Field-Tested)"{
"currency": "USD",
"updated_at": "2026-08-05T12:00:00.000Z",
"market_hash_name": "AK-47 | Redline (Field-Tested)",
"price": 14.50,
"quantity": 12,
"item_page": "https://skincash.gg/en/market/item/ak-47-redline-field-tested"
}Метадані товару — зображення, тип, рідкість для кожного товару у продажу (без цін). Дозволяє відображати й пов’язувати оголошення SkinCash без скрапінгу. Той самий 5-хвилинний кеш + умовний GET, що й у /prices.
curl -s --compressed https://api.skincash.gg/v1/catalog{
"updated_at": "2026-08-05T12:00:00.000Z",
"count": 25812,
"items": [
{
"market_hash_name": "AK-47 | Redline (Field-Tested)",
"image": "https://cdn.skincash.gg/sc/economy/image/class/730/…",
"type": "Rifle",
"rarity": "Classified"
}
]
}Пошук товарів за (частковою) назвою → ціна купівлі + канонічне пряме посилання. Поверхня для порівняння й переходу для інструментів порівняння цін і браузерних розширень. Точні збіги та збіги за префіксом ідуть першими.
qрядок · обов’язковий2–200 символів, без урахування регістру.limitціле число · за бажанням1–100, за замовчуванням 50.curl -s "https://api.skincash.gg/v1/search?q=redline&limit=5"{
"currency": "USD",
"updated_at": "2026-08-05T12:00:00.000Z",
"query": "redline",
"count": 1,
"items": [
{
"market_hash_name": "AK-47 | Redline (Field-Tested)",
"price": 14.50,
"quantity": 12,
"item_page": "https://skincash.gg/en/market/item/ak-47-redline-field-tested"
}
]
}Машиночитна специфікація OpenAPI 3.1 для всього API — перша зупинка для генераторів коду, API-клієнтів і LLM.
curl -s https://api.skincash.gg/v1/openapi.jsonСхема відповіді
Поле updated_at рівня фіду відображає свіжість кожного рядка: усі ціни оновлюються разом щоцикла (~5 хв). Ціни — це ціна купівлі, яку сплачує клієнт.
Ефективний опитувальний запит (ETag / 304)
Кожна відповідь містить ETag і Last-Modified. Надсилайте їх назад під час наступного опитування, щоб отримати дешеву відповідь 304 Not Modified (без тіла), коли нічого не змінилося — опитуйте так часто, як хочете, без повторного завантаження каталогу.
# Save the ETag from the first response, then:
curl -s -o /dev/null -w "%{http_code}\n" \
-H 'If-None-Match: "your-saved-etag"' \
https://api.skincash.gg/v1/prices
# -> 304 when unchanged, 200 (with body) when refreshedЛіміти запитів
Повні вивантаження — /prices, /catalog
Легкі запити — /prices/{name}, /search
Ліміти встановлюються за IP і розділені за вагою відповіді. Фід кешується, тож з умовними запитами 5-хвилинне опитування ніколи навіть не наближається до ліміту. Перевищення ліміту повертає 429 RATE_LIMITED із заголовком Retry-After. Потрібні вищі ліміти для інтеграції з високим трафіком? Напишіть нам щодо партнерського ключа.
Версіонування та стабільність
API версіонується у шляху (/v1). У межах версії ми лише додаємо поля — наявне поле ніколи не перейменовується, не видаляється й не змінює тип, тож ваш парсер не зламається. Несумісні зміни виходять як нова версія, із попередженням.
Помилки
Помилки завжди мають одну послідовну форму тіла:
{
"success": false,
"error": {
"error_code": "NOT_FOUND",
"message": "No live price for this item."
}
}Керуєте агрегатором чи розширенням?
Додайте SkinCash як джерело — фід вище готовий до використання вже сьогодні. Ми радо адаптуємося під вашу специфікацію завантаження, додамо поля або налаштуємо партнерську співпрацю. Зв’яжіться з нами — і ми діятимемо швидко.
[email protected]