Steam

Spiele

Rufe eine Liste der Spiele eines Steam-Benutzers ab, einschließlich Spielzeit-Statistiken und erweiterter App-Infos.

Endpunkt

Dieser Endpunkt gibt eine Liste der Spiele zurück, die der angegebene Benutzer besitzt, einschließlich Spielzeit-Statistiken und erweiterter Anwendungsinformationen. Die Spielebibliothek des Benutzers muss auf öffentlich gesetzt sein, damit dieser Endpunkt Daten liefert.

GET   /v2/steam/users/{steamid}/games

Erforderliche Parameter

steamid
string
Die Steam ID des Benutzers, dessen Spielebibliothek du abrufen möchtest. Akzeptiert verschiedene Steam ID Formate.

Authentifizierung

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

x-api-key: YourSecretAPIKey

Antwortfelder

Die Antwort ist ein Array von Spiel-Objekten.

Spiel-Objekt

FeldTypBeschreibung
appidnumberDie Steam Application-ID des Spiels
namestringDer Name des Spiels
playtime_forevernumberGesamtspielzeit in Minuten
playtime_2weeksnumberSpielzeit der letzten 2 Wochen in Minuten (nur vorhanden, wenn kürzlich gespielt)
img_icon_urlstringHash zur Konstruktion der Spielicon-URL
has_community_visible_statsbooleanOb das Spiel sichtbare Community-Statistiken hat
playtime_windows_forevernumberGesamtspielzeit auf Windows in Minuten
playtime_mac_forevernumberGesamtspielzeit auf Mac in Minuten
playtime_linux_forevernumberGesamtspielzeit auf Linux in Minuten
playtime_deck_forevernumberGesamtspielzeit auf Steam Deck in Minuten
rtime_last_playednumberUnix-Zeitstempel, wann das Spiel zuletzt gespielt wurde

Das Feld img_icon_url enthält einen Hash, keine vollständige URL. Um das tatsächliche Icon-Bild zu erhalten, kombiniere es mit der appid nach diesem Muster:

https://media.steampowered.com/steamcommunity/public/images/apps/{appid}/{img_icon_url}.jpg

Zum Beispiel mit den Counter-Strike 2 Daten aus der Antwort unten:

https://media.steampowered.com/steamcommunity/public/images/apps/730/8dbc71957312bbd3baea65848b545be9eae2a355.jpg

Antwortbeispiel

Beispielausgabe für diesen Endpunkt. Der Kürze halber wurden einige Spiele ausgelassen.

response.json
{
  "success": true,
  "response": [
    {
      "appid": 730,
      "name": "Counter-Strike 2",
      "playtime_forever": 134068,
      "img_icon_url": "8dbc71957312bbd3baea65848b545be9eae2a355",
      "has_community_visible_stats": true,
      "playtime_windows_forever": 134068,
      "playtime_mac_forever": 0,
      "playtime_linux_forever": 0,
      "playtime_deck_forever": 0,
      "rtime_last_played": 1706000000
    },
    {
      "appid": 570,
      "name": "Dota 2",
      "playtime_forever": 2708,
      "playtime_2weeks": 120,
      "img_icon_url": "0bbb630d63262dd66d2fdd0f7d37e8661a410075",
      "has_community_visible_stats": true,
      "playtime_windows_forever": 2708,
      "playtime_mac_forever": 0,
      "playtime_linux_forever": 0,
      "playtime_deck_forever": 0,
      "rtime_last_played": 1706100000
    }
  ]
}