Steam
Jogos
Obtenha a lista de jogos de um usuário Steam incluindo estatísticas de tempo de jogo e informações estendidas.
Endpoint
Este endpoint retorna a lista de jogos do usuário especificado, incluindo estatísticas de tempo de jogo e informações estendidas da aplicação. A biblioteca de jogos do usuário precisa estar configurada como pública para que este endpoint retorne dados.
GET /v2/steam/users/{steamid}/games
Parâmetros obrigatórios
steamid
string
O Steam ID do usuário cuja biblioteca de jogos você quer buscar. Aceita vários formatos de Steam ID.
Autenticação
Inclua sua API key no header x-api-key.
x-api-key: YourSecretAPIKey
Campos da resposta
A resposta é um array de objetos de jogo.
Objeto de jogo
| Campo | Tipo | Descrição |
|---|---|---|
appid | number | O ID da aplicação Steam do jogo |
name | string | O nome do jogo |
playtime_forever | number | Tempo total de jogo em minutos |
playtime_2weeks | number | Tempo de jogo nas últimas 2 semanas em minutos (presente apenas se jogado recentemente) |
img_icon_url | string | Hash para construir a URL do ícone do jogo |
has_community_visible_stats | boolean | Se o jogo tem estatísticas de comunidade visíveis |
playtime_windows_forever | number | Tempo total de jogo no Windows em minutos |
playtime_mac_forever | number | Tempo total de jogo no Mac em minutos |
playtime_linux_forever | number | Tempo total de jogo no Linux em minutos |
playtime_deck_forever | number | Tempo total de jogo no Steam Deck em minutos |
rtime_last_played | number | Unix timestamp de quando o jogo foi jogado pela última vez |
O campo img_icon_url contém um hash, não uma URL completa. Para obter a imagem real do ícone, combine-o com o appid usando este padrão:
https://media.steampowered.com/steamcommunity/public/images/apps/{appid}/{img_icon_url}.jpg
Por exemplo, usando os dados do Counter-Strike 2 da resposta abaixo:
https://media.steampowered.com/steamcommunity/public/images/apps/730/8dbc71957312bbd3baea65848b545be9eae2a355.jpg
Exemplo de resposta
Exemplo de output para este endpoint. Por brevidade, alguns jogos foram omitidos.
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
}
]
}