| key |
string |
ja
|
Dein API-Schlüssel zur Authentifizierung. Für alle Requests erforderlich.
Hole deinen API-Schlüssel im Dashboard → oben rechts → Bereich API Key. |
| game |
string |
nein
|
Spiel-Identifikator. Jedes Spiel hat unterschiedliche Item-Eigenschaften und Märkte.
**Unterstützte Spiele:**
- `cs2` (Standard): Counter-Strike 2 - Volle Unterstützung inklusive echter Marktpreise
- `rust`: Rust - Grundlegende Steam-Marktdaten
- `dota`: Dota 2 - Grundlegende Steam-Marktdaten
- `tf2`: Team Fortress 2 - Grundlegende Steam-Marktdaten |
| page |
integer |
nein
|
Seitenzahl für die Paginierung. In Verbindung mit dem Parameter `max` verwenden.
- Seite 1 liefert Items 1-50000 (mit Standard-max)
- Seite 2 liefert Items 50001-100000 usw. |
| max |
integer |
nein
|
Maximale Anzahl an Items pro Seite. Niedrigere Werte verbessern die Antwortzeit.
**Empfehlungen:**
- Nutze 100-1000 für Webanwendungen
- Nutze höhere Werte für Datenexporte
- Maximum: 50000 Items pro Request z. B. 100
|
| limit |
integer |
nein
|
Alias für `max`, akzeptiert für Clients, die den gebräuchlicheren Namen verwenden. Wird nur angewendet, wenn `max` fehlt — ein explizites `max` gewinnt immer, und wenn keines von beiden gesendet wird, bleibt der Standardwert 50000 bestehen. z. B. 12
|
| sort_by |
string |
nein
|
Sortierreihenfolge der Ergebnisse.
⚠️ **Performance-Hinweis:** Sortierung kann Antworten bei großen Ergebnismengen deutlich verlangsamen. Nutze Filter (`price_min`, `item_group` usw.), um die Datenmenge vor dem Sortieren zu reduzieren, oder verwende für beste Performance den Standard `priceAz`.
**Preisbasierte Sortierung:**
- `priceAz` (Standard): Steam-Listungspreis aufsteigend (günstigste zuerst) - *Am schnellsten*
- `priceZa`: Steam-Listungspreis absteigend (teuerste zuerst)
- `priceRealAz`: Drittanbieter-Marktpreis aufsteigend
- `priceRealZa`: Drittanbieter-Marktpreis absteigend
**Win/Loss-Sortierung** (Preisvergleich Steam vs. Markt):
- `winner`: Beste Deals zuerst (Steam günstiger als Märkte)
- `loser`: Schlechteste Deals zuerst (Steam teurer)
- `winLossAz`: Win/Loss aufsteigend
- `winLossZa`: Win/Loss absteigend
- `winnerRandom`: Gewinner zuerst, innerhalb der Gruppe zufällig
- `loserRandom`: Verlierer zuerst, innerhalb der Gruppe zufällig
**Volumenbasierte Sortierung:**
- `soldAz`: Am wenigsten verkaufte Items zuerst
- `soldZa`: Meistverkaufte Items zuerst (beliebte Items)
- `pointsAz`: Niedrigste Marktkapitalisierung zuerst
- `pointsZa`: Höchste Marktkapitalisierung zuerst
**Weitere:**
- `name`: Alphabetisch nach Market-Hash-Namen
- `random`: Zufällige Reihenfolge (nützlich zum Entdecken) - *Am langsamsten* |
| search |
string |
nein
|
Items nach Namen durchsuchen. Mindestens 3 Zeichen erforderlich.
**Beispiele:**
- `search=AK-47` - Findet alle AK-47-Skins
- `search=Doppler` - Findet alle Doppler-Items (Messer, Handschuhe)
- `search=Redline` - Findet Redline-Skins über alle Waffen hinweg
Die Suche unterscheidet nicht zwischen Groß- und Kleinschreibung und findet auch Teilübereinstimmungen. |
| price_min |
number |
nein
|
Minimaler Steam-Market-Listungspreis in USD.
- Items unter diesem Preis werden ausgeschlossen
- In Kombination mit `price_max` nutzen, um einen Preisbereich festzulegen
- Preise sind in der Basiswährung (USD), sofern `currency` nicht angegeben ist |
| price_max |
number |
nein
|
Maximaler Steam-Market-Listungspreis in USD.
- Items über diesem Preis werden ausgeschlossen
- Das Steam-Market-Maximum liegt bei ~3000 $ (variiert je nach Region)
- In Kombination mit `price_min` nutzen, um einen Preisbereich festzulegen |
| price_real_min |
number |
nein
|
Minimaler Drittanbieter-Marktpreis in USD.
- Filtert nach dem niedrigsten verfügbaren Preis über alle Drittanbieter-Märkte hinweg
- Nützlich, um Arbitrage-Möglichkeiten zu finden |
| price_real_max |
number |
nein
|
Maximaler Drittanbieter-Marktpreis in USD.
- Filtert nach dem niedrigsten verfügbaren Preis über alle Drittanbieter-Märkte hinweg
- Hochpreisige Items können die Steam-Market-Grenze (3000 $) überschreiten |
| item_group |
string |
nein
|
Filter nach Item-Kategorie/-Gruppe.
**CS2-Gruppen:**
- `knife` - Alle Messer (Karambit, Butterfly usw.)
- `gloves` - Alle Handschuhe
- `pistol` - Pistolen (Glock, USP-S, Desert Eagle usw.)
- `rifle` - Gewehre (AK-47, M4A1-S usw.)
- `sniper rifle` - Scharfschützengewehre (AWP, SSG 08 usw.)
- `smg` - SMGs (MP9, MAC-10 usw.)
- `shotgun` - Schrotflinten
- `machinegun` - Maschinengewehre (M249, Negev)
- `case` - Waffenkisten
- `capsule` - Sticker-Kapseln
- `collection` - Kollektionen
Mehrere Gruppen: `knife,gloves` (kommagetrennt) |
| item_type |
string |
nein
|
Filter nach spezifischem Waffentyp innerhalb einer Gruppe.
**Beispiele:**
- `ak-47` - Nur AK-47-Skins
- `awp` - Nur AWP-Skins
- `karambit` - Nur Karambit-Messer
- `m4a1-s` - Nur M4A1-S-Skins
Nutze `/steam/api/info/items?type=types`, um alle verfügbaren Typen zu erhalten. |
| item_name |
string |
nein
|
Filter nach Skin-Name (ohne Waffentyp).
**Beispiele:**
- `redline` - Alle Redline-Skins (AK-47, AWP usw.)
- `doppler` - Alle Doppler-Items
- `asiimov` - Alle Asiimov-Skins
- `fade` - Alle Fade-Items
Nutze `/steam/api/info/items?type=items`, um alle verfügbaren Namen zu erhalten. |
| wear |
string |
nein
|
Filter nach Zustand/Wear-Stufe des Items.
**Wear-Stufen:**
- `fn` - Factory New (0.00 - 0.07 Float)
- `mw` - Minimal Wear (0.07 - 0.15 Float)
- `ft` - Field-Tested (0.15 - 0.38 Float)
- `ww` - Well-Worn (0.38 - 0.45 Float)
- `bs` - Battle-Scarred (0.45 - 1.00 Float)
Mehrere Wears: `fn,mw` (kommagetrennt) |
| select |
string |
nein
|
Bestimmte Felder für die Ausgabe auswählen. Reduziert die Response-Größe deutlich.
**Beispiel:** `select=markethashname,pricelatest,image`
**Beliebte Feldauswahlen:**
- Basis: `markethashname,pricelatest,image`
- Trading: `markethashname,pricelatest,pricereal,winloss`
- Vollständiger Preis: `markethashname,pricelatest,pricereal,buyorderprice,sold24h`
Feldnamen müssen exakt den Response-Feldnamen entsprechen (Kleinschreibung). |
| currency |
string |
nein
|
Preise in die angegebene Währung umrechnen.
**Unterstützte Währungen:**
- `USD` (Standard), `EUR`, `GBP`, `TRY`, `RUB`, `CNY`, `JPY`, `BRL`, `PLN`, `CAD`, `AUD`
Wechselkurse werden stündlich von Steam aktualisiert. |
| production |
string |
nein
|
Auf `1` setzen, wenn du in einer Produktivumgebung arbeitest.
**Vorteile:**
- Entfernt Info-/Hinweisfelder aus der Response
- Sauberer, kleinerer Response-Payload
- Wird in zukünftigen API-Versionen erforderlich sein
**Hinweis:** Ist der Parameter nicht gesetzt, können Deprecation-Warnungen erscheinen. |
| format |
string |
nein
|
Ausgabeformat der Response.
**JSON-Formate:**
- `json` (Standard): Standard-JSON
- `gzip`: Gzip-komprimiertes JSON
- `zip`: Zip-komprimiertes JSON
- `ndjson`: Zeilengetrenntes JSON (Streaming)
**Export-Formate:**
- `csv`: Kommagetrennte Werte
- `xml`: XML-Format
- `html`: HTML-Tabelle
**Datenbankformate:**
- `mysql`: MySQL-INSERT-Statements
- `mysql_with_table`: MySQL mit CREATE TABLE
- `pgsql`: PostgreSQL-INSERT-Statements
- `pgsql_with_table`: PostgreSQL mit CREATE TABLE
- `mongo`: MongoDB-Insert-Dokumente |
| pretty |
string |
nein
|
JSON-Ausgabe formatiert darstellen (eingerückt, menschenlesbar).
- `0` (Standard): Minifiziertes JSON (kleinere Größe)
- `1`: Formatiertes JSON (besser lesbar)
Gilt nur für die Formate json, gzip und zip. |
| markets |
string |
nein
|
Drittanbieter-Marktpreise auf bestimmte Märkte einschränken.
**Verfügbare Märkte:**
- `skinbaron` - Skinbaron.de
- `skinport` - Skinport.com
- `dmarket` - DMarket.com
- `buff` - Buff163.com
- `waxpeer` - Waxpeer.com
- `csgotm` - CS.Money / CSGOTradeMoney
- `haloskins` - HaloSkins
- `tradeit` - Tradeit.gg
- `skinbid` - Skinbid.com
**Beispiel:** `markets=skinbaron,buff,skinport`
Bei Angabe ist `pricereal` der niedrigste Preis ausschließlich unter den gewählten Märkten. |
| with_preview_items |
boolean |
nein
|
Hängt neu entdeckte Items an, die noch nicht vollständig indexiert sind.
- `0` oder `false` (Standard): Liefert nur vollständig indexierte Items
- `1` oder `true`: Hängt in der Datenbank fehlende Items aus der neuesten Skin-Kollektions-Release-Welle am Ende an
Preview-Items haben:
- Das Flag `preview: true`
- Eingeschränkte Daten (keine Preise, nur grundlegende Metadaten)
- Ein 6 Stunden lang gecachtes Snapshot der Datenbankverfügbarkeit
Nützlich, um den vollständigen aktuellen Katalog zurückzugeben, während neue Kollektions-Items noch
nicht vollständig indexiert sind. Historisch in der Datenbank fehlende Items werden nicht angehängt.
Der gemeinsame ByMykel-Katalog wird durch einen Fünf-Minuten-Hintergrundjob aktualisiert.
Preview-IDs verwenden den normalen Item-ID-Algorithmus; tag7 enthält den Kollektionsnamen.
steamlisting wird aus einem Quell-Steam-Economy-Bild abgeleitet, nicht live geprüft.
Beide Preview-Optionen teilen sich dieselben Felder und dasselbe select-Verhalten; preview bleibt bei select immer erhalten. |
| only_new_items |
string |
nein
|
Auf 1 oder true setzen, um CS2-Skins zu erhalten, die in der Datenbank in der neuesten Skin-Kollektions-Release-Welle fehlen. Jede Skin-Kollektion mit dem neuesten gemeinsamen Release-Datum wird einbezogen. Undatierte und zukünftige Kollektionen sind ausgeschlossen. Hat Vorrang vor with_preview_items. Unterstützt search, wear, item_type, item_group, item_name, collection_id, page, max und select. Verwendet dieselben Preview-Felder wie with_preview_items: normale Item-IDs, Kollektion in tag7 und steamlisting abgeleitet aus Quell-Steam-Economy-Bildern (keine Live-Seitenprüfung). preview=true bleibt auch bei select erhalten. |
| collection_id |
string |
nein
|
Schränke only_new_items=1 oder true auf eine exakte ByMykel-Kollektions-ID innerhalb der neuesten Release-Welle ein. |