GET /v1/listings — просмотр актуальных листингов маркетплейса CS2
Получите актуальные доступные для покупки листинги CS2 с float, paint seed, наклейками и ценой продажи в USD. Фильтруйте по износу, категории, редкости, диапазону float и другим параметрам.
Authorization: Bearer csb_pub_....
Query-параметры
market_hash_name товара — запрос разбивается на слова, и каждое сопоставляется как подстрока, идеально подходит для поиска. Обратите внимание: имя, слова которого являются подмножеством более длинного имени предмета (например, Spectrum Case и Spectrum 2 Case), нельзя изолировать таким способом. Для одного конкретного предмета используйте name.market_hash_name (регистр не учитывается). Точный способ получить листинги одного конкретного предмета — name=Spectrum Case вернёт только Spectrum Case, никогда Spectrum 2 Case. Имеет приоритет над search, если переданы оба параметра.Rifle, Knife, Gloves, Pistol.Factory New, Minimal Wear, Field-Tested, Well-Worn, Battle-Scarred.Classified, Covert, Extraordinary.0.0 до 1.0.0.0 до 1.0.only возвращает только предметы StatTrak™; exclude исключает их из результатов.only возвращает только сувенирные предметы; exclude исключает их из результатов.sort=newest обычный ответ — пустая страница, и именно это делает частый опрос дешёвым вместо полного перечитывания на каждом тике.Перекрывайте свою вотермарку примерно на 60 секунд и дедуплицируйте по id. Отправляйте max(listed_at) - 60s, а не голый максимум. Временные метки берутся из момента НАЧАЛА транзакции БД, опубликовавшей листинг, поэтому большая транзакция может закоммитить строки со штампом раньше, чем строки меньшей и более поздней транзакции, уже закоммиченные. Вотермарка, сдвинутая ровно на максимум, перешагнёт такие листинги навсегда.id (стабильный по умолчанию), newest, price_asc, price_desc. newest сортирует по listed_at, поэтому перевыставленные предметы всплывают наравне с действительно новыми.next_cursor из предыдущего ответа, чтобы получить следующую страницу.1, максимум 200.Поля ответа
cursor, чтобы получить следующую страницу. null на последней странице.Пагинация
Этот эндпоинт использует keyset-пагинацию. Чтобы пройти все страницы:- Выполните первый запрос (без
cursor). - Если
next_cursorне равен null, повторите запрос сcursor=<next_cursor>. - Остановитесь, когда
next_cursorстанетnull— вы дошли до последней страницы.
Пример запроса
Пример ответа
Коды ошибок
Авторизации
Send your key as a Bearer token on every request: Authorization: Bearer csb_pub_.... Generate keys in your CSBoard profile.
Параметры запроса
Full-text match on market hash name.
Exact market_hash_name (case-insensitive) — the precise single-item lookup. Unlike fuzzy search, it isolates one item even when its name is a word-subset of a longer one (e.g. Spectrum Case vs Spectrum 2 Case). Takes precedence over search.
e.g. Rifle, Knife, Gloves.
Item wear bucket.
Factory New, Minimal Wear, Field-Tested, Well-Worn, Battle-Scarred e.g. Classified, Covert.
Minimum price in USD.
Maximum price in USD.
Minimum float value.
Maximum float value.
Delivery bucket, the same three the site's grid shows. instant = bot fulfilment (seconds to minutes); up_to_12h = a human seller on the source market must send the trade; hold = inside a Steam trade lock until the item's tradable_at. Any other value is a 400.
instant, up_to_12h, hold Only listings whose refund_percent is at least this (0-100). Listings with no published figure are EXCLUDED, not assumed. Combine with delivery=instant for a pool that ships now and is fully refundable on a Steam reversal.
0 <= x <= 100Filter StatTrak™ items.
only, exclude Filter Souvenir items.
only, exclude ISO-8601 timestamp. Returns only listings that entered the catalogue after it — the delta-poll parameter. Pair with sort=newest; the usual response is an empty page, which is what makes frequent polling cheap instead of a full rescan every tick.
Overlap your watermark by ~60 seconds and dedupe by id. Send max(listed_at) - 60s, never the bare maximum. Timestamps come from the start of the database transaction that published the listing, so a large batch can commit rows stamped earlier than rows a smaller, later batch already committed; a watermark advanced to the exact maximum steps over those listings permanently.
Sort order. Default id. newest orders by listed_at (when the item entered the catalogue), so re-listings surface too.
id, newest, price_asc, price_desc Keyset cursor from next_cursor.
1–200. Default 50.
1 <= x <= 200