Eşyalar

Öğe Detayları

Belirli bir Steam pazar öğesi için metadata, histogram ve fiyat geçmişi dahil tüm detayları al.

Endpoint

Bu endpoint, belirli bir Steam pazar öğesi için kapsamlı verileri döndürür; öğe kaydı, metadata, en son alış/satış histogramı ve fiyat geçmişi dahil.

GET /v2/steam/items/{appId}/{marketHashName}

Gerekli parametreler

appId

number

Öğenin ait olduğu Steam application ID.

marketHashName

string

Öğenin URL-encoded market hash name'i.

Kimlik Doğrulama

API anahtarını x-api-key request header'ı olarak ekle.

x-api-key: YourSecretAPIKey

Yanıt alanları

Alan	Tip	Açıklama
`item`	object	Öğe kaydı
`meta`	object\|null	Öğe metadata'sı (görseller, etiketler, açıklamalar)
`histogram`	object\|null	En son alış/satış emri histogramı
`priceHistory`	object\|null	Geçmiş fiyat verileri

Öğe nesnesi

Alan	Tip	Açıklama
`_id`	string	Belge ID'si
`nameId`	number\|null	Steam pazar ad ID'si
`appId`	number	Steam application ID
`marketName`	string	Pazar görüntü adı
`marketHashName`	string	URL-encoded pazar adı
`classId`	number\|null	Steam class ID
`instanceId`	number\|null	Steam instance ID
`isGlitched`	boolean	Öğe listelemesinin hatalı olup olmadığı
`metaUpdatedAt`	string\|null	Son metadata güncellemesinin ISO timestamp'i
`histogramUpdatedAt`	string\|null	Son histogram güncellemesinin ISO timestamp'i
`priceHistoryUpdatedAt`	string\|null	Son fiyat geçmişi güncellemesinin ISO timestamp'i

Güncelleme sıklığı. Steam Community Market öğeleri genellikle her 24 saatte bir yenilenir. CS2 (appId 730) ve Rust (appId 252490) şu anda her 1 ila 2 saatte bir yenilenmektedir. Sıklık, scraper'ları ayarladıkça değişebilir, bir kaydın en son ne zaman yenilendiğini tam olarak bilmeniz gerekiyorsa *UpdatedAt timestamp alanlarını kontrol edin.

Meta nesnesi

Alan	Tip	Açıklama
`appId`	number	Steam application ID
`contextId`	number	Steam envanter context ID'si
`classId`	number	Steam class ID
`instanceId`	number	Steam instance ID
`image`	object	Öğe görsel URL'leri
`image.iconUrl`	string\|null	İkon görseli URL'si
`image.iconUrlLarge`	string\|null	Büyük ikon görseli URL'si
`image.iconDragUrl`	string\|null	Sürükleme ikonu görseli URL'si
`color`	object	Öğe renk bilgisi
`color.name`	string\|null	Ad renk hex kodu
`color.background`	string\|null	Arka plan renk hex kodu
`flags`	object	Öğe bayrakları
`flags.commodity`	boolean	Öğenin emtia olup olmadığı
`flags.marketable`	boolean	Öğenin pazarda satılabilir olup olmadığı
`flags.tradable`	boolean	Öğenin takas edilebilir olup olmadığı
`descriptions`	array	Steam'den gelen açıklama nesneleri dizisi
`tags`	array	Steam'den gelen etiket nesneleri dizisi

Histogram nesnesi

Alan	Tip	Açıklama
`buyOrders`	array	Alış emri fiyat noktalarının dizisi
`buyOrders[].price`	number	Alış emri fiyatı
`buyOrders[].quantity`	number	Bu fiyattaki alış emri sayısı
`sellOrders`	array	Satış listelemesi fiyat noktalarının dizisi
`sellOrders[].price`	number	Satış listeleme fiyatı
`sellOrders[].quantity`	number	Bu fiyattaki satış listelemesi sayısı
`date`	string	Histogramın kaydedildiği zamanın ISO timestamp'i

Fiyat geçmişi nesnesi

Alan	Tip	Açıklama
`data`	array	Geçmiş fiyat noktalarının dizisi
`data[].price`	number	Satış fiyatı
`data[].quantity`	number	Satış sayısı
`data[].date`	string	Satış tarihinin ISO timestamp'i

Yanıt örneği

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" }
      ]
    }
  }
}

Öğeleri Listele

SteamApis tarafından izlenen tüm Steam pazar öğelerinin sayfalı listesini isteğe bağlı filtreleme ile al.

Öğe Meta

Belirli bir Steam pazar öğesi için görseller, etiketler ve takas bayrakları dahil metadata'yı al.