REST
Artikel suchen
Suche nach Artikeln anhand des Namens über Marktplätze hinweg und erhalte eine schlanke Liste von Treffern.
Endpunkt
Sucht Artikel nach Namen und gibt eine schlanke Liste von Treffern zurück. Nützlich für Autocomplete und zum Ermitteln des exakten Marktnamens, den du an Artikel abrufen übergibst.
GET /v2/items/search
Queryparameter
game
string
Spielcode (z. B.
CS2, Dota2, Rust, TF2).query
string
Suchbegriff, der gegen Artikelnamen abgeglichen wird.
marketplace
string
Optionaler Marktplatz-Filter. Weglassen, um über alle Marktplätze hinweg zu suchen.
limit
number
Maximale Anzahl zurückgegebener Ergebnisse. Standard ist
100.Authentifizierung
Siehe REST-Übersicht für Basis-URL, Authentifizierung und Fehlerformat.
Antwortfelder
Die Antwort ist ein Array von Artikel-Zusammenfassungsobjekten.
| 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 |
offerCount | number | Anzahl offener Angebote |
thumbnail | string|null | URL zum Vorschaubild des Artikels |
updatedAt | number | Unix-Zeitstempel der letzten Aktualisierung |
Antwortbeispiel
response.json
[
{
"name": "AK-47 | Redline (Field-Tested)",
"marketplace": "Buff163",
"game": "CS2",
"priceUSD": 45.99,
"offerCount": 128,
"thumbnail": "https://community.cloudflare.steamstatic.com/economy/image/...",
"updatedAt": 1711152000
},
{
"name": "AK-47 | Redline (Minimal Wear)",
"marketplace": "Buff163",
"game": "CS2",
"priceUSD": 78.20,
"offerCount": 42,
"thumbnail": "https://community.cloudflare.steamstatic.com/economy/image/...",
"updatedAt": 1711152000
}
]