Przedmioty
Lista przedmiotów
Pobierz paginowaną listę wszystkich przedmiotów rynku Steam śledzonych przez SteamApis z opcjonalnym filtrowaniem.
Endpoint
Ten endpoint zwraca paginowaną listę wszystkich przedmiotów rynku Steam śledzonych przez SteamApis. Opcjonalnie możesz filtrować przedmioty według czasu, kiedy ich metadane, histogram lub historia cen zostały ostatnio zaktualizowane.
GET /v2/steam/items
Parametry query
cursor
string
Kursor paginacji. Przekaż wartość
cursor z poprzedniej odpowiedzi, aby pobrać kolejną stronę.metaUpdatedAfter
string
Filtruj przedmioty, których metadane zostały zaktualizowane po tym timestampie ISO.
histogramUpdatedAfter
string
Filtruj przedmioty, których dane histogramu zostały zaktualizowane po tym timestampie ISO.
priceHistoryUpdatedAfter
string
Filtruj przedmioty, których historia cen została zaktualizowana po tym timestampie ISO.
Uwierzytelnianie
Dołącz swój klucz API jako header x-api-key.
x-api-key: YourSecretAPIKey
Pola odpowiedzi
| Pole | Typ | Opis |
|---|---|---|
results | array | Tablica obiektów przedmiotów |
cursor | string|null | Kursor do następnej strony lub null, jeśli nie ma więcej wyników |
hasMore | boolean | Czy są dostępne kolejne wyniki do pobrania |
Obiekt przedmiotu
| Pole | Typ | Opis |
|---|---|---|
_id | string | ID dokumentu (używane jako wartość kursora oraz jako itemId dla innych endpointów) |
nameId | number|null | ID nazwy rynkowej Steam |
appId | number | Steam application ID |
marketName | string | Wyświetlana nazwa rynkowa |
marketHashName | string | Nazwa rynkowa zakodowana w URL (używana w URL-ach Steam) |
classId | number|null | Steam class ID |
instanceId | number|null | Steam instance ID |
isGlitched | boolean | Czy listing przedmiotu jest zgłitchowany na Steam |
metaUpdatedAt | string|null | ISO timestamp ostatniej aktualizacji metadanych |
histogramUpdatedAt | string|null | ISO timestamp ostatniej aktualizacji histogramu |
priceHistoryUpdatedAt | string|null | ISO timestamp ostatniej aktualizacji historii cen |
Przykład odpowiedzi
Przykładowy output dla tego endpointu. Dla zwięzłości niektóre przedmioty zostały pominięte.
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
}
}
Ten endpoint zwraca do 10 000 wyników na zapytanie. Użyj paginacji opartej na kursorze, aby pobrać wszystkie przedmioty.