Apps
Avaliações de App
Obtenha uma lista paginada de avaliações de usuários para uma aplicação Steam específica.
Endpoint
Este endpoint retorna uma lista paginada de avaliações de usuários para uma aplicação Steam específica. Cada entrada inclui o texto da avaliação, o Steam ID do autor e o tempo de jogo no momento da avaliação, contagem de votos e timestamps.
GET /v2/steam/apps/{appId}/reviews
Parâmetros obrigatórios
appId
number
O ID da aplicação Steam.
Parâmetros de consulta
cursor
string
Cursor de paginação. Passe o valor
cursor de uma resposta anterior para buscar a próxima página.Autenticação
Inclua sua chave de API como cabeçalho de requisição x-api-key.
x-api-key: YourSecretAPIKey
Campos da resposta
| Campo | Tipo | Descrição |
|---|---|---|
results | array | Array de objetos de avaliação. |
cursor | string | Cursor para a próxima página. |
hasMore | boolean | Se há mais resultados disponíveis. Quando false, você chegou à última página. |
Objeto de avaliação
| Campo | Tipo | Descrição |
|---|---|---|
_id | string | ID do documento. |
recommendationId | string | Identificador da avaliação do Steam. |
appId | number | ID da aplicação Steam à qual a avaliação pertence. |
author | object | Informações do autor. Veja campos abaixo. |
commentCount | number | Número de comentários na avaliação. |
language | string | Idioma da avaliação (ex.: english, french, german). |
receivedForFree | boolean | Se o autor recebeu o produto gratuitamente. |
review | string | Texto do corpo da avaliação. |
steamPurchase | boolean | Se o autor comprou o produto no Steam. |
timestampCreated | number | Timestamp Unix (segundos) de quando a avaliação foi publicada pela primeira vez. |
timestampUpdated | number | Timestamp Unix (segundos) da última edição da avaliação. |
votedUp | boolean | true para avaliação positiva (recomendada), false para negativa. |
votesFunny | number | Número de votos "engraçado" recebidos pela avaliação. |
votesUp | number | Número de votos "útil" recebidos pela avaliação. |
weightedVoteScore | string | Pontuação ponderada de utilidade do Steam (valor decimal como string, 0–1). |
writtenDuringEarlyAccess | boolean | Se a avaliação foi escrita durante o Early Access. |
Objeto do autor
| Campo | Tipo | Descrição |
|---|---|---|
steamId | string | O Steam ID de 64 bits do avaliador. |
playtimeAtReview | number | Minutos que o autor havia jogado no momento da avaliação. |
Exemplo de resposta
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
}
Use paginação baseada em cursor para recuperar o histórico completo de avaliações. Quando
hasMore é false, você chegou à última página.