REST
Pobierz przedmiot
Pobierz pojedynczy przedmiot z określonego marketplace'u, w tym jego bieżące oferty i otwarte zlecenia kupna.
Endpoint
Zwraca pełne dane pojedynczego przedmiotu na jednym marketplace, w tym każdą obecnie wystawioną ofertę i każde otwarte zlecenie kupna.
GET /v2/items
Parametry zapytania
marketplace
string
Nazwa marketplace'u (np.
Buff163). Wielkość liter nie ma znaczenia.game
string
Kod gry (np.
CS2, Dota2, Rust, TF2).name
string
Pełna rynkowa nazwa przedmiotu (np.
AK-47 | Redline (Field-Tested)).Uwierzytelnianie
Zobacz Przegląd REST po bazowy URL, uwierzytelnianie i format błędów.
Pola odpowiedzi
| Pole | Typ | Opis |
|---|---|---|
name | string | Rynkowa nazwa przedmiotu |
marketplace | string | Marketplace, na którym przedmiot jest wystawiony |
game | string | Gra, do której należy przedmiot |
priceUSD | number|null | Najniższa cena oferty w USD |
priceEUR | number|null | Najniższa cena oferty w EUR |
priceCNY | number|null | Najniższa cena oferty w CNY |
priceRUB | number|null | Najniższa cena oferty w RUB |
offerCount | number | Liczba otwartych ofert |
condition | string|null | Stan przedmiotu (np. Field-Tested) |
thumbnail | string|null | URL do miniatury przedmiotu |
updatedAt | number | Unix timestamp (sekundy) ostatniej aktualizacji |
offers | array | Tablica obiektów oferty |
buyOrders | array | Tablica obiektów zlecenia kupna |
Obiekt oferty
| Pole | Typ | Opis |
|---|---|---|
purchaseLink | string|null | Bezpośredni link do zakupu przedmiotu na marketplace |
inspectLink | string|null | Link Steam inspect (tylko CS2) |
priceUSD | number|null | Cena oferty w USD |
priceEUR | number|null | Cena oferty w EUR |
priceCNY | number|null | Cena oferty w CNY |
priceRUB | number|null | Cena oferty w RUB |
float | number|null | Wartość zużycia między 0.0 a 1.0 (tylko CS2) |
paintIndex | number|null | ID wzoru skina (tylko CS2) |
paintSeed | number|null | Numer seed wzoru (tylko CS2) |
daysTradeLocked | number|null | Dni do momentu, gdy przedmiot będzie wymienialny |
foundAt | number | Unix timestamp wykrycia oferty |
updatedAt | number | Unix timestamp ostatniej aktualizacji |
stickers | array|null | Naklejone naklejki (tylko CS2) |
ownerId | string|null | Identyfikator sprzedawcy na marketplace |
Obiekt zlecenia kupna
| Pole | Typ | Opis |
|---|---|---|
orderId | string|null | ID zlecenia specyficzne dla marketplace'u |
quantity | number|null | Liczba żądanych jednostek |
priceUSD | number|null | Cena oferowana w USD |
priceEUR | number|null | Cena oferowana w EUR |
priceCNY | number|null | Cena oferowana w CNY |
priceRUB | number|null | Cena oferowana w RUB |
itemPhase | string|null | Faza lub wariant przedmiotu (fazy doppler CS2 itp.) |
updatedAt | number | Unix timestamp ostatniej aktualizacji |
Przykład odpowiedzi
response.json
{
"name": "AK-47 | Redline (Field-Tested)",
"marketplace": "Buff163",
"game": "CS2",
"priceUSD": 45.99,
"priceEUR": 42.50,
"priceCNY": 325.00,
"priceRUB": 4200.00,
"offerCount": 128,
"condition": "Field-Tested",
"thumbnail": "https://community.cloudflare.steamstatic.com/economy/image/...",
"updatedAt": 1711152000,
"offers": [
{
"purchaseLink": "https://buff.163.com/goods/...",
"inspectLink": "steam://rungame/730/...",
"priceUSD": 45.99,
"priceEUR": 42.50,
"priceCNY": 325.00,
"priceRUB": 4200.00,
"float": 0.2341,
"paintIndex": 282,
"paintSeed": 123,
"daysTradeLocked": 0,
"foundAt": 1711150000,
"updatedAt": 1711152000,
"stickers": [],
"ownerId": "user-abc"
}
],
"buyOrders": [
{
"orderId": "order-xyz",
"quantity": 5,
"priceUSD": 43.00,
"priceEUR": 39.80,
"priceCNY": 305.00,
"priceRUB": 3950.00,
"itemPhase": null,
"updatedAt": 1711151800
}
]
}