REST
Artikel abrufen
Einen einzelnen Artikel von einem bestimmten Marktplatz abrufen, einschließlich aktueller Angebote und offener Kaufaufträge.
Endpunkt
Gibt die vollständigen Daten eines einzelnen Artikels auf einem einzelnen Marktplatz zurück, einschließlich aller aktuell gelisteten Angebote und aller offenen Kaufaufträge.
GET /v2/items
Queryparameter
marketplace
string
Marktplatzname (z. B.
Buff163). Groß-/Kleinschreibung wird nicht unterschieden.game
string
Spielcode (z. B.
CS2, Dota2, Rust, TF2).name
string
Vollständiger Marktname des Artikels (z. B.
AK-47 | Redline (Field-Tested)).Authentifizierung
Siehe REST-Übersicht für Basis-URL, Authentifizierung und Fehlerformat.
Antwortfelder
| Feld | Typ | Beschreibung |
|---|---|---|
name | string | Marktname des Artikels |
marketplace | string | Marktplatz, auf dem der Artikel gelistet ist |
game | string | Spiel, zu dem der Artikel gehört |
priceUSD | number|null | Niedrigster Angebotspreis in USD |
priceEUR | number|null | Niedrigster Angebotspreis in EUR |
priceCNY | number|null | Niedrigster Angebotspreis in CNY |
priceRUB | number|null | Niedrigster Angebotspreis in RUB |
offerCount | number | Anzahl offener Angebote |
condition | string|null | Artikelzustand (z. B. Field-Tested) |
thumbnail | string|null | URL zum Vorschaubild des Artikels |
updatedAt | number | Unix-Zeitstempel (Sekunden) der letzten Aktualisierung |
offers | array | Array von Angebots-Objekten |
buyOrders | array | Array von Kaufauftrags-Objekten |
Angebots-Objekt
| Feld | Typ | Beschreibung |
|---|---|---|
purchaseLink | string|null | Direktlink zum Kauf des Artikels auf dem Marktplatz |
inspectLink | string|null | Steam-Inspect-Link (nur CS2) |
priceUSD | number|null | Angebotspreis in USD |
priceEUR | number|null | Angebotspreis in EUR |
priceCNY | number|null | Angebotspreis in CNY |
priceRUB | number|null | Angebotspreis in RUB |
float | number|null | Verschleißwert zwischen 0.0 und 1.0 (nur CS2) |
paintIndex | number|null | Skin-Muster-ID (nur CS2) |
paintSeed | number|null | Muster-Seed-Nummer (nur CS2) |
daysTradeLocked | number|null | Tage, bis der Artikel handelbar wird |
foundAt | number | Unix-Zeitstempel, als das Angebot erkannt wurde |
updatedAt | number | Unix-Zeitstempel der letzten Aktualisierung |
stickers | array|null | Angebrachte Sticker (nur CS2) |
ownerId | string|null | Verkäufer-Kennung auf dem Marktplatz |
Kaufauftrags-Objekt
| Feld | Typ | Beschreibung |
|---|---|---|
orderId | string|null | Marktplatz-spezifische Auftrags-ID |
quantity | number|null | Anzahl angefragter Einheiten |
priceUSD | number|null | Gebotspreis in USD |
priceEUR | number|null | Gebotspreis in EUR |
priceCNY | number|null | Gebotspreis in CNY |
priceRUB | number|null | Gebotspreis in RUB |
itemPhase | string|null | Artikelphase oder Variante (CS2-Doppler-Phasen usw.) |
updatedAt | number | Unix-Zeitstempel der letzten Aktualisierung |
Antwortbeispiel
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
}
]
}