Steam

Insígnias

Obtenha insígnias de usuário Steam incluindo XP, nível e detalhes de conclusão.

Endpoint

Este endpoint retorna os dados de insígnias de um usuário Steam, incluindo nível da insígnia, XP ganho e timestamps de conclusão. Esses dados faziam parte do endpoint de summary na v1 e agora estão disponíveis como endpoint dedicado.

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

Parâmetros obrigatórios

steamid

string

O Steam ID do usuário cujas insígnias 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

Campo	Tipo	Descrição
`badges`	array	Array de objetos de insígnia
`player_xp`	number	XP total ganho pelo jogador
`player_level`	number	Nível Steam atual do jogador
`player_xp_needed_to_level_up`	number	XP necessário para alcançar o próximo nível
`player_xp_needed_current_level`	number	XP necessário para o nível atual

Objeto de insígnia

Campo	Tipo	Descrição
`badgeid`	number	O ID da insígnia
`appid`	number	ID da aplicação (para insígnias de jogos específicos, opcional)
`level`	number	Nível atual da insígnia
`completion_time`	number	Unix timestamp de quando a insígnia foi obtida ou evoluída
`xp`	number	XP ganho com esta insígnia
`scarcity`	number	Número de usuários que possuem esta insígnia
`communityitemid`	string	ID do item da comunidade (para insígnias de jogos, opcional)
`border_color`	number	Valor da cor da borda (para insígnias de jogos, opcional)

Exemplo de resposta

Exemplo de output para este endpoint. Por brevidade, algumas insígnias foram omitidas.

response.json

{
  "success": true,
  "response": {
    "badges": [
      {
        "badgeid": 13,
        "level": 625,
        "completion_time": 1766289028,
        "xp": 875,
        "scarcity": 916315
      },
      {
        "badgeid": 1,
        "appid": 730,
        "level": 5,
        "completion_time": 1415375204,
        "xp": 500,
        "communityitemid": "1111254987",
        "border_color": 0,
        "scarcity": 9204132
      }
    ],
    "player_xp": 23450,
    "player_level": 42,
    "player_xp_needed_to_level_up": 50,
    "player_xp_needed_current_level": 400
  }
}

Inventário

Obtenha o inventário de um usuário Steam para uma determinada aplicação e contexto, retornando os ativos junto com as descrições que resolvem os metadados visuais e de mercado de cada ativo.

Jogos

Obtenha a lista de jogos de um usuário Steam incluindo estatísticas de tempo de jogo e informações estendidas.