Visão geral REST

Visão geral

A API REST de Dados de Marketplace fornece acesso a listagens de itens, ordens de compra, histórico de preços e dados de vendas de marketplaces Steam de terceiros. É um serviço separado da API principal do Steam e funciona em seu próprio host.

URL base

Todos os endpoints REST são servidos a partir de um único host.

https://marketplaceapi.steamapis.com/v2/

Autenticação

Inclua sua chave de API como cabeçalho de requisição X-API-Key. Cabeçalhos HTTP não diferenciam maiúsculas de minúsculas, então x-api-key também funciona.

X-API-Key: YourSecretAPIKey

Alternativamente, passe a chave como parâmetro de consulta apiKey. O cabeçalho é preferido.

https://marketplaceapi.steamapis.com/v2/marketplaces?apiKey=YourSecretAPIKey

Formato de resposta

Uma resposta bem-sucedida é um único objeto ou um array de objetos, dependendo do endpoint. Por exemplo, GET /v2/marketplaces retorna um array diretamente no nível superior do corpo.

Erros

Erros são retornados com um status HTTP não-2xx e um corpo JSON contendo uma mensagem error e um code legível por máquina.

{
  "error": "Marketplace not found",
  "code": "NOT_FOUND"
}

Cache e limites de taxa

As respostas são armazenadas em cache no servidor por 10 segundos. Não há limites de taxa no cliente — o cache absorve tráfego repetido.

Endpoints disponíveis

• GET /v2/marketplaces — listar marketplaces suportados
• GET /v2/items — buscar um único item com ofertas e ordens de compra
• GET /v2/items/search — pesquisar itens por nome
• GET /v2/items/compare — comparar um item entre marketplaces
• GET /v2/buy-orders — listar ordens de compra
• GET /v2/price-history — série temporal de histórico de preços
• GET /v2/sales — vendas recentes