Przedmioty

Szczegóły przedmiotu

Pobierz pełne szczegóły konkretnego przedmiotu rynku Steam, w tym metadane, histogram i historię cen.

Endpoint

Ten endpoint zwraca kompleksowe dane dla konkretnego przedmiotu rynku Steam, w tym rekord przedmiotu, metadane, najnowszy histogram zleceń kupna/sprzedaży oraz historię cen.

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

Wymagane parametry

appId

number

Steam application ID, do którego należy przedmiot.

marketHashName

string

Market hash name przedmiotu zakodowany w URL.

Uwierzytelnianie

Dołącz swój klucz API jako header x-api-key.

x-api-key: YourSecretAPIKey

Pola odpowiedzi

Pole	Typ	Opis
`item`	object	Rekord przedmiotu
`meta`	object\|null	Metadane przedmiotu (obrazy, tagi, opisy)
`histogram`	object\|null	Najnowszy histogram zleceń kupna/sprzedaży
`priceHistory`	object\|null	Historyczne dane cenowe

Obiekt przedmiotu

Pole	Typ	Opis
`_id`	string	ID dokumentu
`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
`classId`	number\|null	Steam class ID
`instanceId`	number\|null	Steam instance ID
`isGlitched`	boolean	Czy listing przedmiotu jest zgłitchowany
`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

Częstotliwość aktualizacji. Przedmioty Steam Community Market są zwykle odświeżane co 24 godziny. CS2 (appId 730) i Rust (appId 252490) są obecnie odświeżane co 1 do 2 godzin. Częstotliwość może się zmieniać w miarę dostrajania scraperów, sprawdź pola *UpdatedAt z timestampami, jeśli musisz wiedzieć dokładnie, kiedy rekord został ostatnio odświeżony.

Obiekt meta

Pole	Typ	Opis
`appId`	number	Steam application ID
`contextId`	number	ID kontekstu ekwipunku Steam
`classId`	number	Steam class ID
`instanceId`	number	Steam instance ID
`image`	object	URL-e obrazów przedmiotu
`image.iconUrl`	string\|null	URL obrazu ikony
`image.iconUrlLarge`	string\|null	URL dużego obrazu ikony
`image.iconDragUrl`	string\|null	URL obrazu ikony drag
`color`	object	Informacje o kolorach przedmiotu
`color.name`	string\|null	Kod hex koloru nazwy
`color.background`	string\|null	Kod hex koloru tła
`flags`	object	Flagi przedmiotu
`flags.commodity`	boolean	Czy przedmiot jest towarem
`flags.marketable`	boolean	Czy przedmiot można sprzedać na rynku
`flags.tradable`	boolean	Czy przedmiot można wymieniać
`descriptions`	array	Tablica obiektów opisów ze Steam
`tags`	array	Tablica obiektów tagów ze Steam

Obiekt histogram

Pole	Typ	Opis
`buyOrders`	array	Tablica punktów cenowych zleceń kupna
`buyOrders[].price`	number	Cena zlecenia kupna
`buyOrders[].quantity`	number	Liczba zleceń kupna w tej cenie
`sellOrders`	array	Tablica punktów cenowych listingów sprzedaży
`sellOrders[].price`	number	Cena listingu sprzedaży
`sellOrders[].quantity`	number	Liczba listingów sprzedaży w tej cenie
`date`	string	ISO timestamp zarejestrowania histogramu

Obiekt price history

Pole	Typ	Opis
`data`	array	Tablica historycznych punktów cenowych
`data[].price`	number	Cena sprzedaży
`data[].quantity`	number	Liczba sprzedaży
`data[].date`	string	ISO timestamp daty sprzedaży

Przykład odpowiedzi

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

Lista przedmiotów

Pobierz paginowaną listę wszystkich przedmiotów rynku Steam śledzonych przez SteamApis z opcjonalnym filtrowaniem.

Meta przedmiotu

Pobierz metadane dla konkretnego przedmiotu rynku Steam, w tym obrazy, tagi i flagi handlowe.