Предметы
Список предметов
Получи пагинированный список всех Steam-предметов рынка, отслеживаемых SteamApis, с опциональной фильтрацией.
Эндпоинт
Этот endpoint возвращает пагинированный список всех Steam-предметов рынка, отслеживаемых SteamApis. Ты можешь опционально фильтровать предметы по времени последнего обновления метаданных, гистограммы или истории цен.
GET /v2/steam/items
Query-параметры
appId
number
Фильтрация предметов по appId.
cursor
string
Cursor пагинации. Передай значение
cursor из предыдущего ответа, чтобы получить следующую страницу.metaUpdatedAfter
string
Отфильтровать предметы, у которых метаданные обновлены после этого ISO timestamp.
histogramUpdatedAfter
string
Отфильтровать предметы, у которых данные гистограммы обновлены после этого ISO timestamp.
priceHistoryUpdatedAfter
string
Отфильтровать предметы, у которых история цен обновлена после этого ISO timestamp.
Аутентификация
Включи свой API-ключ в request header x-api-key.
x-api-key: YourSecretAPIKey
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
results | array | Массив объектов предметов |
cursor | string|null | Cursor для следующей страницы или null, если больше результатов нет |
hasMore | boolean | Есть ли ещё результаты для получения |
Объект предмета
| Поле | Тип | Описание |
|---|---|---|
_id | string | ID документа (используется как значение cursor и как itemId для других endpoint'ов) |
nameId | number|null | Steam market name ID |
appId | number | Steam application ID |
marketName | string | Отображаемое имя на рынке |
marketHashName | string | URL-кодированное имя на рынке (используется в URL-ах Steam) |
classId | number|null | Steam class ID |
instanceId | number|null | Steam instance ID |
isGlitched | boolean | Является ли листинг предмета «глюченым» в Steam |
metaUpdatedAt | string|null | ISO timestamp последнего обновления метаданных |
histogramUpdatedAt | string|null | ISO timestamp последнего обновления гистограммы |
priceHistoryUpdatedAt | string|null | ISO timestamp последнего обновления истории цен |
Пример ответа
Пример вывода для этого endpoint'а. Для краткости некоторые предметы опущены.
response.json
{
"success": true,
"response": {
"results": [
{
"_id": "6789abcdef012345",
"nameId": 176096978,
"appId": 730,
"marketName": "AK-47 | Redline (Field-Tested)",
"marketHashName": "AK-47 %7C Redline %28Field-Tested%29",
"classId": 310777487,
"instanceId": 480085569,
"isGlitched": false,
"metaUpdatedAt": "2025-01-15T00:00:00.000Z",
"histogramUpdatedAt": "2025-01-15T00:00:00.000Z",
"priceHistoryUpdatedAt": "2025-01-15T00:00:00.000Z"
}
],
"cursor": "6789abcdef012345",
"hasMore": true
}
}
Этот endpoint возвращает до 10 000 результатов за запрос. Используй пагинацию на основе cursor, чтобы получить все предметы.