Предметы
Детали предмета
Получи полные детали для конкретного Steam-предмета рынка, включая метаданные, гистограмму и историю цен.
Эндпоинт
Этот endpoint возвращает исчерпывающие данные о конкретном Steam-предмете рынка, включая запись о предмете, метаданные, последнюю гистограмму покупки/продажи и историю цен.
GET /v2/steam/items/{appId}/{marketHashName}
Обязательные параметры
appId
number
Steam application ID, которому принадлежит предмет.
marketHashName
string
URL-кодированный market hash name предмета.
Аутентификация
Включи свой API-ключ в request header x-api-key.
x-api-key: YourSecretAPIKey
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
item | object | Запись о предмете |
meta | object|null | Метаданные предмета (изображения, теги, описания) |
histogram | object|null | Последняя гистограмма ордеров на покупку/продажу |
priceHistory | object|null | Исторические данные о ценах |
Объект item
| Поле | Тип | Описание |
|---|---|---|
_id | string | ID документа |
nameId | number|null | Steam market name ID |
appId | number | Steam application ID |
marketName | string | Отображаемое имя на рынке |
marketHashName | string | URL-кодированное имя на рынке |
classId | number|null | Steam class ID |
instanceId | number|null | Steam instance ID |
isGlitched | boolean | Является ли листинг предмета «глюченым» |
metaUpdatedAt | string|null | ISO timestamp последнего обновления метаданных |
histogramUpdatedAt | string|null | ISO timestamp последнего обновления гистограммы |
priceHistoryUpdatedAt | string|null | ISO timestamp последнего обновления истории цен |
Частота обновления. Предметы Steam Community Market обычно обновляются каждые 24 часа. CS2 (appId
730) и Rust (appId 252490) в настоящее время обновляются каждые 1–2 часа. Частота может меняться по мере настройки скраперов, проверяй поля timestamp *UpdatedAt, если тебе нужно точно знать, когда запись была обновлена в последний раз.Объект meta
| Поле | Тип | Описание |
|---|---|---|
appId | number | Steam application ID |
contextId | number | Steam inventory context ID |
classId | number | Steam class ID |
instanceId | number | Steam instance ID |
image | object | URL-ы изображений предмета |
image.iconUrl | string|null | URL изображения иконки |
image.iconUrlLarge | string|null | URL изображения большой иконки |
image.iconDragUrl | string|null | URL изображения drag-иконки |
color | object | Информация о цветах предмета |
color.name | string|null | Hex-код цвета имени |
color.background | string|null | Hex-код цвета фона |
flags | object | Флаги предмета |
flags.commodity | boolean | Является ли предмет commodity |
flags.marketable | boolean | Доступен ли предмет для продажи на рынке |
flags.tradable | boolean | Можно ли обменять предмет |
descriptions | array | Массив объектов описаний из Steam |
tags | array | Массив объектов тегов из Steam |
Объект histogram
| Поле | Тип | Описание |
|---|---|---|
buyOrders | array | Массив ценовых уровней ордеров на покупку |
buyOrders[].price | number | Цена ордера на покупку |
buyOrders[].quantity | number | Количество ордеров на покупку по этой цене |
sellOrders | array | Массив ценовых уровней листингов на продажу |
sellOrders[].price | number | Цена листинга на продажу |
sellOrders[].quantity | number | Количество листингов на продажу по этой цене |
date | string | ISO timestamp записи гистограммы |
Объект price history
| Поле | Тип | Описание |
|---|---|---|
data | array | Массив исторических точек цены |
data[].price | number | Цена продажи |
data[].quantity | number | Количество продаж |
data[].date | string | ISO timestamp даты продажи |
Пример ответа
response.json
{
"success": true,
"response": {
"item": {
"_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"
},
"meta": {
"appId": 730,
"contextId": 2,
"classId": 310777487,
"instanceId": 480085569,
"image": {
"iconUrl": "-9a81dlWLwJ2UXnc...",
"iconUrlLarge": "-9a81dlWLwJ2UXnc...",
"iconDragUrl": null
},
"color": {
"name": "D2D2D2",
"background": null
},
"flags": {
"commodity": false,
"marketable": true,
"tradable": true
},
"descriptions": [],
"tags": []
},
"histogram": {
"buyOrders": [
{ "price": 1050, "quantity": 245 },
{ "price": 1049, "quantity": 12 }
],
"sellOrders": [
{ "price": 1089, "quantity": 3 },
{ "price": 1090, "quantity": 7 }
],
"date": "2025-01-15T12:00:00.000Z"
},
"priceHistory": {
"data": [
{ "price": 1075, "quantity": 150, "date": "2025-01-14T00:00:00.000Z" },
{ "price": 1062, "quantity": 142, "date": "2025-01-13T00:00:00.000Z" }
]
}
}
}