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 открыт, поэтому вы можете обращаться к API прямо из браузера. Просто отправьте запрос:
Анонимный доступ ограничен по количеству запросов на 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строка · обязательныйТочное Steam market_hash_name, в 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]