REST
Ürün Al
Belirli bir pazar yerinden tek bir ürünü, mevcut teklifleri ve açık satın alma emirleri dahil olmak üzere getirin.
Endpoint
Tek bir pazar yerindeki tek bir ürünün tam verilerini, şu anda listelenmiş her teklifi ve her açık satın alma emrini dahil olmak üzere döndürür.
GET /v2/items
Sorgu parametreleri
marketplace
string
Pazar yeri adı (ör.
Buff163). Büyük/küçük harf duyarsızdır.game
string
Oyun kodu (ör.
CS2, Dota2, Rust, TF2).name
string
Ürünün tam pazar adı (ör.
AK-47 | Redline (Field-Tested)).Kimlik doğrulama
Temel URL, kimlik doğrulama ve hata formatı için REST Genel Bakış sayfasına bakın.
Yanıt alanları
| Alan | Tip | Açıklama |
|---|---|---|
name | string | Ürünün pazar adı |
marketplace | string | Ürünün listelendiği pazar yeri |
game | string | Ürünün ait olduğu oyun |
priceUSD | number|null | USD cinsinden en düşük teklif fiyatı |
priceEUR | number|null | EUR cinsinden en düşük teklif fiyatı |
priceCNY | number|null | CNY cinsinden en düşük teklif fiyatı |
priceRUB | number|null | RUB cinsinden en düşük teklif fiyatı |
offerCount | number | Açık teklif sayısı |
condition | string|null | Ürün durumu (ör. Field-Tested) |
thumbnail | string|null | Ürün küçük resim URL'si |
updatedAt | number | Son güncellemenin Unix zaman damgası (saniye) |
offers | array | Teklif nesneleri dizisi |
buyOrders | array | Satın alma emri nesneleri dizisi |
Teklif nesnesi
| Alan | Tip | Açıklama |
|---|---|---|
purchaseLink | string|null | Pazar yerinde ürünü satın almak için doğrudan bağlantı |
inspectLink | string|null | Steam inspect bağlantısı (sadece CS2) |
priceUSD | number|null | USD cinsinden teklif fiyatı |
priceEUR | number|null | EUR cinsinden teklif fiyatı |
priceCNY | number|null | CNY cinsinden teklif fiyatı |
priceRUB | number|null | RUB cinsinden teklif fiyatı |
float | number|null | 0.0 ile 1.0 arasında aşınma değeri (sadece CS2) |
paintIndex | number|null | Skin desen ID'si (sadece CS2) |
paintSeed | number|null | Desen seed numarası (sadece CS2) |
daysTradeLocked | number|null | Ürünün takas edilebilir hale gelmesine kalan gün sayısı |
foundAt | number | Teklifin algılandığı Unix zaman damgası |
updatedAt | number | Son güncellemenin Unix zaman damgası |
stickers | array|null | Uygulanmış çıkartmalar (sadece CS2) |
ownerId | string|null | Pazar yerindeki satıcı tanımlayıcısı |
Satın alma emri nesnesi
| Alan | Tip | Açıklama |
|---|---|---|
orderId | string|null | Pazar yerine özgü emir ID'si |
quantity | number|null | İstenen birim sayısı |
priceUSD | number|null | USD cinsinden teklif fiyatı |
priceEUR | number|null | EUR cinsinden teklif fiyatı |
priceCNY | number|null | CNY cinsinden teklif fiyatı |
priceRUB | number|null | RUB cinsinden teklif fiyatı |
itemPhase | string|null | Ürün fazı veya varyantı (CS2 doppler fazları vb.) |
updatedAt | number | Son güncellemenin Unix zaman damgası |
Yanıt örneği
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
}
]
}