Aplikacje
Recenzje aplikacji
Pobierz paginowaną listę recenzji użytkowników dla konkretnej aplikacji Steam.
Endpoint
Ten endpoint zwraca paginowaną listę recenzji użytkowników dla konkretnej aplikacji Steam. Każdy wpis zawiera tekst recenzji, Steam ID autora i czas gry w momencie recenzji, liczby głosów oraz znaczniki czasu.
GET /v2/steam/apps/{appId}/reviews
Wymagane parametry
appId
number
ID aplikacji Steam.
Parametry zapytania
cursor
string
Kursor paginacji. Przekaż wartość
cursor z poprzedniej odpowiedzi, aby pobrać następną stronę.Uwierzytelnianie
Dołącz swój klucz API jako nagłówek żądania x-api-key.
x-api-key: YourSecretAPIKey
Pola odpowiedzi
| Pole | Typ | Opis |
|---|---|---|
results | array | Tablica obiektów recenzji. |
cursor | string | Kursor dla następnej strony. |
hasMore | boolean | Czy są dostępne kolejne wyniki. Gdy false, dotarłeś do ostatniej strony. |
Obiekt recenzji
| Pole | Typ | Opis |
|---|---|---|
_id | string | ID dokumentu. |
recommendationId | string | Identyfikator recenzji Steam. |
appId | number | ID aplikacji Steam, do której należy recenzja. |
author | object | Informacje o autorze. Zobacz pola poniżej. |
commentCount | number | Liczba komentarzy do recenzji. |
language | string | Język recenzji (np. english, french, german). |
receivedForFree | boolean | Czy autor otrzymał produkt za darmo. |
review | string | Treść recenzji. |
steamPurchase | boolean | Czy autor kupił produkt na Steam. |
timestampCreated | number | Unix timestamp (sekundy) pierwszej publikacji recenzji. |
timestampUpdated | number | Unix timestamp (sekundy) ostatniej edycji recenzji. |
votedUp | boolean | true dla pozytywnej (polecanej) recenzji, false dla negatywnej. |
votesFunny | number | Liczba głosów "śmieszne" dla recenzji. |
votesUp | number | Liczba głosów "pomocne" dla recenzji. |
weightedVoteScore | string | Ważony wynik przydatności Steam (wartość dziesiętna jako string, 0–1). |
writtenDuringEarlyAccess | boolean | Czy recenzja została napisana podczas Early Access. |
Obiekt autora
| Pole | Typ | Opis |
|---|---|---|
steamId | string | 64-bitowy Steam ID recenzenta. |
playtimeAtReview | number | Minuty, które autor zagrał w momencie pisania recenzji. |
Przykład odpowiedzi
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
}
Użyj paginacji opartej na kursorze, aby pobrać pełną historię recenzji. Gdy
hasMore ma wartość false, dotarłeś do ostatniej strony.