Steam

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.

Endpoint

Este endpoint retorna o inventário Steam de um usuário para uma aplicação e contexto específicos. A resposta espelha o formato de inventário da própria Steam: um array assets listando os itens possuídos e um array descriptions que resolve os metadados visuais e de mercado de cada ativo através de classid + instanceid.

GET /v2/steam/users/{steamid}/inventory/{appId}/{contextId}

Parâmetros obrigatórios

steamid

string

O Steam ID do usuário cujo inventário você quer buscar. Aceita vários formatos de Steam ID.

appId

number

O ID da aplicação Steam do jogo cujo inventário você quer buscar (ex. 730 para Counter-Strike 2).

contextId

number

O ID de contexto dentro do inventário da aplicação. Para a maioria dos jogos, o ID de contexto é 2.

Autenticação

Inclua sua API key no header x-api-key.

x-api-key: YourSecretAPIKey

Campos da resposta

Campo	Tipo	Descrição
`assets`	array	Os itens possuídos pelo usuário. Cada ativo referencia uma descrição através de `classid` + `instanceid`.
`descriptions`	array	Metadados que descrevem cada classe/instância única de item referenciada por `assets`. Normalmente vários ativos compartilham uma única descrição.

Objeto de ativo

Campo	Tipo	Descrição
`appid`	number	ID da aplicação à qual o ativo pertence.
`contextid`	string	ID do contexto em que o ativo se encontra.
`assetid`	string	ID único deste ativo específico no inventário do usuário.
`classid`	string	ID de classe usado para localizar a descrição do ativo.
`instanceid`	string	ID de instância usado (junto com `classid`) para localizar a descrição do ativo.
`amount`	string	Quantidade deste ativo. Quase sempre `"1"` fora de itens empilháveis.

Objeto de descrição

Campo	Tipo	Descrição
`appid`	number	ID da aplicação.
`classid`	string	ID de classe — corresponde a `assets[].classid`.
`instanceid`	string	ID de instância — corresponde a `assets[].instanceid`.
`currency`	number	`1` se o item for uma moeda do jogo, `0` caso contrário.
`background_color`	string	Cor hexadecimal usada atrás do ícone do item na interface da Steam.
`icon_url`	string	Caminho relativo para o ícone do item na CDN da Steam.
`icon_url_large`	string	Caminho relativo para o ícone grande do item na CDN da Steam (nem sempre presente).
`descriptions`	array	Linhas de descrição em rich-text (texto da arma, conteúdo de caixas, atributos, etc.).
`tradable`	number	`1` se o item pode ser trocado, `0` caso contrário.
`marketable`	number	`1` se o item pode ser vendido no Steam Community Market, `0` caso contrário.
`commodity`	number	`1` se o item é uma commodity (fungível), `0` caso contrário.
`market_tradable_restriction`	number	Dias restantes até o item se tornar negociável.
`market_marketable_restriction`	number	Dias restantes até o item se tornar vendável no mercado.
`name`	string	Nome de exibição do item.
`name_color`	string	Cor hexadecimal usada para o nome do item na interface da Steam (reflete a raridade).
`type`	string	Classificação de tipo do item (ex. `"Base Grade Container"`, `"Mil-Spec Grade SMG"`).
`market_name`	string	Nome de exibição no mercado.
`market_hash_name`	string	Nome de mercado seguro para URL, usado para consultar endpoints de mercado.
`actions`	array	Ações dentro do jogo, como links de inspeção. Nem sempre presente.
`market_actions`	array	Ações no escopo do mercado, como links de inspeção a partir da página do mercado. Nem sempre presente.
`tags`	array	Tags de classificação (tipo, arma, raridade, exterior, coleção, etc.).
`sealed`	number	`1` se o contêiner está lacrado, `0` caso contrário.
`sealed_type`	number	Tipo interno de contêiner lacrado.
`market_bucket_group_name`	string	Nome do agrupamento de bucket do mercado (usado pela Steam para agrupar variantes).
`market_bucket_group_id`	string	ID do agrupamento de bucket do mercado.

As URLs de ícone são relativas. Para renderizá-las, adicione o prefixo da CDN da Steam:

https://community.cloudflare.steamstatic.com/economy/image/{icon_url}

Exemplo de resposta

Por brevidade, os arrays assets e descriptions foram truncados — uma resposta real contém um ativo por item no inventário e uma descrição por par único de classid + instanceid.

response.json

{
  "success": true,
  "result": {
    "assets": [
      {
        "appid": 730,
        "contextid": "2",
        "assetid": "50813022021",
        "classid": "5710094579",
        "instanceid": "8336926543",
        "amount": "1"
      }
    ],
    "descriptions": [
      {
        "appid": 730,
        "classid": "5710094579",
        "instanceid": "8336926543",
        "currency": 0,
        "background_color": "393b3e",
        "icon_url": "i0CoZ81Ui0m-9KwlBY1L_18myuGuq1wfhWSaZgMttyVfPaERSR0Wqmu7LAocGJKz2lu_XsnXwtmkJjSU91dh8bj35VTqVBP4io_frnEVvqf_a6VoIfGSXz7Hlbwg57QwSS_mxhl15jiGyN37c3_GZw91W8BwRflK7EfKsa2sfw",
        "tradable": 1,
        "name": "Kilowatt Case",
        "name_color": "b0c3d9",
        "type": "Base Grade Container",
        "market_name": "Kilowatt Case",
        "market_hash_name": "Kilowatt Case",
        "commodity": 1,
        "market_tradable_restriction": 7,
        "market_marketable_restriction": 7,
        "marketable": 1,
        "tags": [
          { "category": "Type", "internal_name": "CSGO_Type_WeaponCase", "localized_category_name": "Type", "localized_tag_name": "Container" },
          { "category": "Rarity", "internal_name": "Rarity_Common", "localized_category_name": "Quality", "localized_tag_name": "Base Grade", "color": "b0c3d9" }
        ],
        "sealed": 0,
        "sealed_type": 0,
        "market_bucket_group_name": "Kilowatt Case",
        "market_bucket_group_id": "G18A8263004"
      }
    ]
  }
}

Grupos

Obtém os grupos Steam aos quais um usuário pertence, como uma lista de IDs de grupo.

Insígnias

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