Apps
App-Bewertungen
Erhalte eine paginierte Liste von Nutzerbewertungen für eine bestimmte Steam-Anwendung.
Endpunkt
Dieser Endpunkt gibt eine paginierte Liste von Nutzerbewertungen für eine bestimmte Steam-Anwendung zurück. Jeder Eintrag enthält den Bewertungstext, die Steam-ID des Autors und seine Spielzeit zum Zeitpunkt der Bewertung, Stimmenzählungen und Zeitstempel.
GET /v2/steam/apps/{appId}/reviews
Erforderliche Parameter
appId
number
Die Steam-Anwendungs-ID.
Query-Parameter
cursor
string
Paginierungs-Cursor. Übergib den
cursor-Wert aus einer vorherigen Antwort, um die nächste Seite zu laden.Authentifizierung
Gib deinen API-Schlüssel als x-api-key-Anfrageheader an.
x-api-key: YourSecretAPIKey
Antwortfelder
| Feld | Typ | Beschreibung |
|---|---|---|
results | array | Array von Bewertungsobjekten. |
cursor | string | Cursor für die nächste Seite. |
hasMore | boolean | Ob weitere Ergebnisse verfügbar sind. Bei false hast du die letzte Seite erreicht. |
Bewertungsobjekt
| Feld | Typ | Beschreibung |
|---|---|---|
_id | string | Dokument-ID. |
recommendationId | string | Steams Bewertungs-Identifikator. |
appId | number | Steam-Anwendungs-ID, zu der die Bewertung gehört. |
author | object | Autoreninformationen. Siehe Felder unten. |
commentCount | number | Anzahl der Kommentare zur Bewertung. |
language | string | Sprache der Bewertung (z. B. english, french, german). |
receivedForFree | boolean | Ob der Autor das Produkt kostenlos erhalten hat. |
review | string | Text der Bewertung. |
steamPurchase | boolean | Ob der Autor das Produkt auf Steam gekauft hat. |
timestampCreated | number | Unix-Zeitstempel (Sekunden) der ersten Veröffentlichung der Bewertung. |
timestampUpdated | number | Unix-Zeitstempel (Sekunden) der letzten Bearbeitung der Bewertung. |
votedUp | boolean | true für eine positive (empfohlene) Bewertung, false für negative. |
votesFunny | number | Anzahl der "Lustig"-Stimmen für die Bewertung. |
votesUp | number | Anzahl der Hilfreich-Stimmen für die Bewertung. |
weightedVoteScore | string | Steams gewichtete Hilfreichkeitsbewertung (Dezimalwert als String, 0–1). |
writtenDuringEarlyAccess | boolean | Ob die Bewertung während des Early Access geschrieben wurde. |
Autorenobjekt
| Feld | Typ | Beschreibung |
|---|---|---|
steamId | string | Die 64-Bit-Steam-ID des Bewertenden. |
playtimeAtReview | number | Minuten, die der Autor zum Zeitpunkt der Bewertung gespielt hatte. |
Antwortbeispiel
response.json
{
"success": true,
"results": [
{
"_id": "69e800477ab054081ee245cd",
"recommendationId": "223802362",
"appId": 2393730,
"author": {
"steamId": "76561198808328024",
"playtimeAtReview": 163
},
"commentCount": 0,
"language": "english",
"receivedForFree": false,
"review": "Great game! Had a lot of fun. It's obviously not a full flight sim, but more of a take off and land sim with management element.",
"steamPurchase": true,
"timestampCreated": 1776804577,
"timestampUpdated": 1776804734,
"votedUp": true,
"votesFunny": 0,
"votesUp": 1,
"weightedVoteScore": "0.529703021049499512",
"writtenDuringEarlyAccess": false
}
],
"cursor": "eyJ2IjoxNzc2NzY4NDg3LCJpZCI6IjY5ZTgwMDQ3N2FiMDU0MDgxZWUyNDVmYSJ9",
"hasMore": true
}
Verwende Cursor-basierte Paginierung, um die vollständige Bewertungshistorie abzurufen. Wenn
hasMorefalse ist, hast du die letzte Seite erreicht.