Itens

Listar Itens

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

Endpoint

Este endpoint retorna uma lista paginada de todos os itens do mercado Steam rastreados pelo SteamApis. Você pode opcionalmente filtrar itens pelo momento em que os metadados, o histograma ou o histórico de preços foram atualizados pela última vez.

GET   /v2/steam/items

Parâmetros de query

appId
number
Filtra itens por appId.
cursor
string
Cursor de paginação. Passe o valor de cursor de uma resposta anterior para obter a próxima página.
metaUpdatedAfter
string
Filtra itens cujos metadados foram atualizados após este timestamp ISO.
histogramUpdatedAfter
string
Filtra itens cujos dados de histograma foram atualizados após este timestamp ISO.
priceHistoryUpdatedAfter
string
Filtra itens cujo histórico de preços foi atualizado após este timestamp ISO.

Autenticação

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

x-api-key: YourSecretAPIKey

Campos da resposta

CampoTipoDescrição
resultsarrayArray de objetos de item
cursorstring|nullCursor para a próxima página, ou null se não houver mais resultados
hasMorebooleanSe há mais resultados disponíveis

Objeto item

CampoTipoDescrição
_idstringID do documento (usado como valor de cursor e como itemId em outros endpoints)
nameIdnumber|nullID do nome de mercado Steam
appIdnumberSteam application ID
marketNamestringNome de exibição no mercado
marketHashNamestringNome de mercado codificado em URL (usado em URLs da Steam)
classIdnumber|nullSteam class ID
instanceIdnumber|nullSteam instance ID
isGlitchedbooleanSe a listagem do item está com problemas na Steam
metaUpdatedAtstring|nullTimestamp ISO da última atualização de metadados
histogramUpdatedAtstring|nullTimestamp ISO da última atualização do histograma
priceHistoryUpdatedAtstring|nullTimestamp ISO da última atualização do histórico de preços

Exemplo de resposta

Exemplo de output para este endpoint. Por brevidade, alguns itens foram omitidos.

response.json
{
  "success": true,
  "response": {
    "results": [
      {
        "_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"
      }
    ],
    "cursor": "6789abcdef012345",
    "hasMore": true
  }
}
Este endpoint retorna até 10.000 resultados por request. Use paginação baseada em cursor para obter todos os itens.