REST
Поиск предметов
Ищите предметы по названию на разных торговых площадках, получая облегчённый список совпадений.
Эндпоинт
Ищет предметы по названию и возвращает облегчённый список совпадений. Полезно для автодополнения и для определения точного рыночного названия, которое нужно передать в Получить предмет.
GET /v2/items/search
Параметры запроса
game
string
Код игры (например,
CS2, Dota2, Rust, TF2).query
string
Поисковая строка для сопоставления с названиями предметов.
marketplace
string
Необязательный фильтр по торговой площадке. Опустите для поиска по всем торговым площадкам.
limit
number
Максимальное количество возвращаемых результатов. По умолчанию
100.Аутентификация
Смотрите Обзор REST для базового URL, аутентификации и формата ошибок.
Поля ответа
Ответ представляет собой массив объектов-сводок предметов.
| Поле | Тип | Описание |
|---|---|---|
name | string | Рыночное название предмета |
marketplace | string | Торговая площадка, на которой выставлен предмет |
game | string | Игра, к которой относится предмет |
priceUSD | number|null | Наименьшая цена предложения в USD |
offerCount | number | Количество открытых предложений |
thumbnail | string|null | URL миниатюры предмета |
updatedAt | number | Unix-время последнего обновления |
Пример ответа
response.json
[
{
"name": "AK-47 | Redline (Field-Tested)",
"marketplace": "Buff163",
"game": "CS2",
"priceUSD": 45.99,
"offerCount": 128,
"thumbnail": "https://community.cloudflare.steamstatic.com/economy/image/...",
"updatedAt": 1711152000
},
{
"name": "AK-47 | Redline (Minimal Wear)",
"marketplace": "Buff163",
"game": "CS2",
"priceUSD": 78.20,
"offerCount": 42,
"thumbnail": "https://community.cloudflare.steamstatic.com/economy/image/...",
"updatedAt": 1711152000
}
]