Itens

Detalhes do Item

Obtenha detalhes completos de um item específico do mercado Steam incluindo metadados, histograma e histórico de preços.

Endpoint

Este endpoint retorna dados abrangentes para um item específico do mercado Steam, incluindo o registro do item, metadados, o histograma de ordens de compra/venda mais recente e o histórico de preços.

GET /v2/steam/items/{appId}/{marketHashName}

Parâmetros obrigatórios

appId

number

O Steam application ID ao qual o item pertence.

marketHashName

string

O market hash name do item codificado em URL.

Autenticação

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

x-api-key: YourSecretAPIKey

Campos da resposta

Campo	Tipo	Descrição
`item`	object	O registro do item
`meta`	object\|null	Metadados do item (imagens, tags, descrições)
`histogram`	object\|null	Histograma mais recente de ordens de compra/venda
`priceHistory`	object\|null	Dados históricos de preço

Objeto item

Campo	Tipo	Descrição
`_id`	string	ID do documento
`nameId`	number\|null	ID do nome de mercado Steam
`appId`	number	Steam application ID
`marketName`	string	Nome de exibição no mercado
`marketHashName`	string	Nome de mercado codificado em URL
`classId`	number\|null	Steam class ID
`instanceId`	number\|null	Steam instance ID
`isGlitched`	boolean	Se a listagem do item está com problemas
`metaUpdatedAt`	string\|null	Timestamp ISO da última atualização de metadados
`histogramUpdatedAt`	string\|null	Timestamp ISO da última atualização do histograma
`priceHistoryUpdatedAt`	string\|null	Timestamp ISO da última atualização do histórico de preços

Frequência de atualização. Itens da Steam Community Market são tipicamente atualizados a cada 24 horas. CS2 (appId 730) e Rust (appId 252490) são atualmente atualizados a cada 1 a 2 horas. A cadência pode mudar à medida que ajustamos os scrapers, verifique os campos de timestamp *UpdatedAt se precisar saber exatamente quando um registro foi atualizado pela última vez.

Objeto meta

Campo	Tipo	Descrição
`appId`	number	Steam application ID
`contextId`	number	Steam inventory context ID
`classId`	number	Steam class ID
`instanceId`	number	Steam instance ID
`image`	object	URLs das imagens do item
`image.iconUrl`	string\|null	URL da imagem de ícone
`image.iconUrlLarge`	string\|null	URL da imagem de ícone grande
`image.iconDragUrl`	string\|null	URL da imagem de ícone de arrastar
`color`	object	Informação de cores do item
`color.name`	string\|null	Código hex da cor do nome
`color.background`	string\|null	Código hex da cor de fundo
`flags`	object	Flags do item
`flags.commodity`	boolean	Se o item é uma mercadoria
`flags.marketable`	boolean	Se o item é vendável no mercado
`flags.tradable`	boolean	Se o item é trocável
`descriptions`	array	Array de objetos de descrição vindos da Steam
`tags`	array	Array de objetos de tag vindos da Steam

Objeto histogram

Campo	Tipo	Descrição
`buyOrders`	array	Array de pontos de preço de ordens de compra
`buyOrders[].price`	number	Preço da ordem de compra
`buyOrders[].quantity`	number	Número de ordens de compra neste preço
`sellOrders`	array	Array de pontos de preço de listagens de venda
`sellOrders[].price`	number	Preço da listagem de venda
`sellOrders[].quantity`	number	Número de listagens de venda neste preço
`date`	string	Timestamp ISO de quando o histograma foi registrado

Objeto price history

Campo	Tipo	Descrição
`data`	array	Array de pontos históricos de preço
`data[].price`	number	Preço de venda
`data[].quantity`	number	Número de vendas
`data[].date`	string	Timestamp ISO da data da venda

Exemplo de resposta

response.json

{
  "success": true,
  "response": {
    "item": {
      "_id": "6789abcdef012345",
      "nameId": 176096978,
      "appId": 730,
      "marketName": "AK-47 | Redline (Field-Tested)",
      "marketHashName": "AK-47 %7C Redline %28Field-Tested%29",
      "classId": 310777487,
      "instanceId": 480085569,
      "isGlitched": false,
      "metaUpdatedAt": "2025-01-15T00:00:00.000Z",
      "histogramUpdatedAt": "2025-01-15T00:00:00.000Z",
      "priceHistoryUpdatedAt": "2025-01-15T00:00:00.000Z"
    },
    "meta": {
      "appId": 730,
      "contextId": 2,
      "classId": 310777487,
      "instanceId": 480085569,
      "image": {
        "iconUrl": "-9a81dlWLwJ2UXnc...",
        "iconUrlLarge": "-9a81dlWLwJ2UXnc...",
        "iconDragUrl": null
      },
      "color": {
        "name": "D2D2D2",
        "background": null
      },
      "flags": {
        "commodity": false,
        "marketable": true,
        "tradable": true
      },
      "descriptions": [],
      "tags": []
    },
    "histogram": {
      "buyOrders": [
        { "price": 1050, "quantity": 245 },
        { "price": 1049, "quantity": 12 }
      ],
      "sellOrders": [
        { "price": 1089, "quantity": 3 },
        { "price": 1090, "quantity": 7 }
      ],
      "date": "2025-01-15T12:00:00.000Z"
    },
    "priceHistory": {
      "data": [
        { "price": 1075, "quantity": 150, "date": "2025-01-14T00:00:00.000Z" },
        { "price": 1062, "quantity": 142, "date": "2025-01-13T00:00:00.000Z" }
      ]
    }
  }
}

Listar Itens

Obtenha uma lista paginada de todos os itens do mercado Steam rastreados pelo SteamApis, com filtros opcionais.

Meta do Item

Obtenha metadados de um item específico do mercado Steam incluindo imagens, tags e flags de troca.