REST-Übersicht
Übersicht
Die Marktdaten-REST-API bietet Zugriff auf Artikelangebote, Kaufaufträge, Preisverlauf und Verkaufsdaten von Drittanbieter-Steam-Marktplätzen. Sie ist ein eigenständiger Dienst, getrennt von der Haupt-Steam-API, und läuft auf einem eigenen Host.
Basis-URL
Alle REST-Endpunkte werden von einem einzigen Host bereitgestellt.
https://marketplaceapi.steamapis.com/v2/
Authentifizierung
Füge deinen API-Schlüssel als X-API-Key-Anfrage-Header hinzu. HTTP-Header unterscheiden nicht zwischen Groß- und Kleinschreibung, daher funktioniert auch x-api-key.
X-API-Key: YourSecretAPIKey
Alternativ kannst du den Schlüssel als apiKey-Queryparameter übergeben. Der Header wird bevorzugt.
https://marketplaceapi.steamapis.com/v2/marketplaces?apiKey=YourSecretAPIKey
Antwortformat
{ "success": true, "response": {...} }-Umschlag. Parse den Antwortkörper direkt.Eine erfolgreiche Antwort ist je nach Endpunkt entweder ein einzelnes Objekt oder ein Array von Objekten. Zum Beispiel liefert GET /v2/marketplaces direkt ein Array auf oberster Ebene des Antwortkörpers.
Fehler
Fehler werden mit einem nicht-2xx HTTP-Status und einem JSON-Body zurückgegeben, der eine error-Nachricht und einen maschinenlesbaren code enthält.
{
"error": "Marketplace not found",
"code": "NOT_FOUND"
}
Caching und Rate Limits
Antworten werden serverseitig 10 Sekunden lang zwischengespeichert. Es gibt keine clientseitigen Rate Limits — der Cache fängt wiederholten Traffic ab.
Verfügbare Endpunkte
- GET /v2/marketplaces — Liste unterstützter Marktplätze
- GET /v2/items — einzelnen Artikel mit Angeboten und Kaufaufträgen abrufen
- GET /v2/items/search — Artikel nach Namen suchen
- GET /v2/items/compare — einen Artikel über Marktplätze hinweg vergleichen
- GET /v2/buy-orders — Kaufaufträge auflisten
- GET /v2/price-history — Preisverlauf-Zeitreihe
- GET /v2/sales — aktuelle Verkäufe