REST
Pesquisar Itens
Pesquise itens por nome em marketplaces, retornando uma lista leve de correspondências.
Endpoint
Pesquisa itens por nome e retorna uma lista leve de correspondências. Útil para autocompletar e para descobrir o nome de mercado exato a ser passado para Obter Item.
GET /v2/items/search
Parâmetros de consulta
game
string
Código do jogo (ex.:
CS2, Dota2, Rust, TF2).query
string
String de pesquisa para comparar com os nomes dos itens.
marketplace
string
Filtro opcional de marketplace. Omita para pesquisar em todos os marketplaces.
limit
number
Número máximo de resultados a retornar. Padrão é
100.Autenticação
Veja Visão geral REST para URL base, autenticação e formato de erros.
Campos da resposta
A resposta é um array de objetos de resumo de itens.
| Campo | Tipo | Descrição |
|---|---|---|
name | string | Nome de mercado do item |
marketplace | string | Marketplace onde o item está listado |
game | string | Jogo ao qual o item pertence |
priceUSD | number|null | Menor preço de oferta em USD |
offerCount | number | Número de ofertas abertas |
thumbnail | string|null | URL da imagem em miniatura do item |
updatedAt | number | Unix timestamp da última atualização |
Exemplo de resposta
response.json
[
{
"name": "AK-47 | Redline (Field-Tested)",
"marketplace": "Buff163",
"game": "CS2",
"priceUSD": 45.99,
"offerCount": 128,
"thumbnail": "https://community.cloudflare.steamstatic.com/economy/image/...",
"updatedAt": 1711152000
},
{
"name": "AK-47 | Redline (Minimal Wear)",
"marketplace": "Buff163",
"game": "CS2",
"priceUSD": 78.20,
"offerCount": 42,
"thumbnail": "https://community.cloudflare.steamstatic.com/economy/image/...",
"updatedAt": 1711152000
}
]