Items

Item-Details

Rufe vollständige Details zu einem bestimmten Steam-Markt-Item ab, einschließlich Metadaten, Histogramm und Preishistorie.

Endpunkt

Dieser Endpunkt gibt umfassende Daten zu einem bestimmten Steam-Markt-Item zurück, einschließlich des Item-Eintrags, der Metadaten, des letzten Kauf-/Verkaufs-Histogramms und der Preishistorie.

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

Erforderliche Parameter

appId

number

Die Steam-Applikations-ID, zu der das Item gehört.

marketHashName

string

Der URL-kodierte Market-Hash-Name des Items.

Authentifizierung

Übergib deinen API-Schlüssel als x-api-key Request-Header.

x-api-key: YourSecretAPIKey

Antwortfelder

Feld	Typ	Beschreibung
`item`	object	Der Item-Eintrag
`meta`	object\|null	Item-Metadaten (Bilder, Tags, Beschreibungen)
`histogram`	object\|null	Neuestes Kauf-/Verkaufsauftrag-Histogramm
`priceHistory`	object\|null	Historische Preisdaten

Item-Objekt

Feld	Typ	Beschreibung
`_id`	string	Dokument-ID
`nameId`	number\|null	Steam-Markt-Namens-ID
`appId`	number	Steam-Applikations-ID
`marketName`	string	Markt-Anzeigename
`marketHashName`	string	URL-kodierter Marktname
`classId`	number\|null	Steam-Class-ID
`instanceId`	number\|null	Steam-Instance-ID
`isGlitched`	boolean	Ob das Item-Listing fehlerhaft ist
`metaUpdatedAt`	string\|null	ISO-Zeitstempel der letzten Metadaten-Aktualisierung
`histogramUpdatedAt`	string\|null	ISO-Zeitstempel der letzten Histogramm-Aktualisierung
`priceHistoryUpdatedAt`	string\|null	ISO-Zeitstempel der letzten Preishistorie-Aktualisierung

Aktualisierungsfrequenz. Items des Steam Community Market werden in der Regel alle 24 Stunden aktualisiert. CS2 (appId 730) und Rust (appId 252490) werden derzeit alle 1 bis 2 Stunden aktualisiert. Die Frequenz kann sich ändern, während wir die Scraper optimieren, prüfe die *UpdatedAt-Zeitstempelfelder, wenn du genau wissen musst, wann ein Eintrag zuletzt aktualisiert wurde.

Meta-Objekt

Feld	Typ	Beschreibung
`appId`	number	Steam-Applikations-ID
`contextId`	number	Steam-Inventar-Kontext-ID
`classId`	number	Steam-Class-ID
`instanceId`	number	Steam-Instance-ID
`image`	object	Item-Bild-URLs
`image.iconUrl`	string\|null	Icon-Bild-URL
`image.iconUrlLarge`	string\|null	URL des großen Icon-Bildes
`image.iconDragUrl`	string\|null	URL des Drag-Icon-Bildes
`color`	object	Item-Farbinformationen
`color.name`	string\|null	Hex-Code der Namensfarbe
`color.background`	string\|null	Hex-Code der Hintergrundfarbe
`flags`	object	Item-Flags
`flags.commodity`	boolean	Ob das Item eine Ware ist
`flags.marketable`	boolean	Ob das Item auf dem Markt verkauft werden kann
`flags.tradable`	boolean	Ob das Item handelbar ist
`descriptions`	array	Array von Beschreibungsobjekten von Steam
`tags`	array	Array von Tag-Objekten von Steam

Histogramm-Objekt

Feld	Typ	Beschreibung
`buyOrders`	array	Array der Kaufauftrags-Preispunkte
`buyOrders[].price`	number	Kaufauftragspreis
`buyOrders[].quantity`	number	Anzahl der Kaufaufträge zu diesem Preis
`sellOrders`	array	Array der Verkaufslisten-Preispunkte
`sellOrders[].price`	number	Verkaufslistenpreis
`sellOrders[].quantity`	number	Anzahl der Verkaufslistungen zu diesem Preis
`date`	string	ISO-Zeitstempel, wann das Histogramm erfasst wurde

Preishistorie-Objekt

Feld	Typ	Beschreibung
`data`	array	Array historischer Preispunkte
`data[].price`	number	Verkaufspreis
`data[].quantity`	number	Anzahl der Verkäufe
`data[].date`	string	ISO-Zeitstempel des Verkaufsdatums

Antwortbeispiel

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

Items auflisten

Rufe eine paginierte Liste aller von SteamApis getrackten Steam-Markt-Items mit optionaler Filterung ab.

Item-Meta

Rufe Metadaten zu einem bestimmten Steam-Markt-Item ab, einschließlich Bildern, Tags und Handels-Flags.