API de preços do CS2: endpoints, limites e licença

API pública para desenvolvedores

Uma API JSON gratuita e somente leitura com preços de itens do CS2, avaliação de inventário Steam, times e jogadores profissionais. Funciona sem chave nem cadastro, CORS aberto, preços em dólares americanos atualizados mais ou menos a cada hora. Uma chave gratuita criada no seu perfil aumenta os limites.

Endpoints

A tabela é gerada a partir do documento OpenAPI; as descrições estão em inglês. Parâmetros marcados com * são obrigatórios.

EndpointRetornaParâmetros
GET /api/v1/inventoryAppraise a public CS2 Steam inventorysteam*lang
GET /api/v1/inventoriesStored appraisals of up to 50 Steam inventories in one call (200 with an API key)steam*lang
GET /api/v1/priceFind CS2 items by name and get their current pricesq*lang
GET /api/v1/price/historyDaily price history of one CS2 itemq*dayslang
GET /api/v1/teamsTop CS2 teams by the official Valve rankingregion
GET /api/v1/teams/{slug}Team profile: roster, trophies, current events, recent matches, map stats and rank historyslug*
GET /api/v1/playersPlayers of the ranked teams, optionally only those with a public Steam profilesteamlimit
GET /api/v1/players/{slug}Player of a ranked teamslug*

Limites

Sem chave, os limites são contados por endereço IP; a próxima seção os compara com os de uma chave pessoal. Assistentes de IA conhecidos, identificados pelo User-Agent, têm uma faixa própria:

Requisições por minuto para assistentes de IA conhecidos em /api/v1
600
Avaliações de inventário por hora para assistentes de IA
600
Consultas por minuto de perfis nunca avaliados, compartilhadas por todos os assistentes de IA
8

Acima do limite a API responde 429, e 503 enquanto calcula uma avaliação nova; as duas respostas trazem Retry-After em segundos. Espere esse tempo e tente de novo uma vez.

Limites maiores com uma chave de API

Todos os endpoints funcionam sem chave. Com uma chave pessoal gratuita, os limites passam a ser contados por chave, e não por endereço IP, e ficam maiores; além disso, /api/v1/inventory espera até 25 s por uma avaliação nova em vez de responder 503.

LimiteSem chaveCom chave
Requisições por minuto120600
Avaliações de inventário por hora60300
Perfis nunca avaliados por minutodentro do limite por hora30
Perfis por chamada a /api/v1/inventories50200

Como obter uma chave

  • Entre pela Steam e abra a seção “Chaves de API” do seu perfil. Ir para o perfil
  • As chaves ficam disponíveis para contas com pelo menos um dia. Você pode manter até 3 chaves ativas, cada uma com um nome que diga para que serve.
  • A chave aparece uma única vez, ao ser criada: guardamos só o hash dela. Uma chave perdida ou vazada é revogada com um clique e trocada por uma nova.

Como enviar a chave

Envie a chave no cabeçalho Authorization com o esquema Bearer ou no cabeçalho X-Api-Key. As chaves só são lidas em /api/v1; não as coloque em código que roda no navegador nem em repositórios públicos.

curl -H "Authorization: Bearer $CS2C_KEY" \
  "https://cs2collections.net/api/v1/price?q=AK-47%20%7C%20Redline"

curl -H "X-Api-Key: $CS2C_KEY" \
  "https://cs2collections.net/api/v1/inventory?steam=76561197960287930"

Cabeçalhos de resposta e erros

X-RateLimit-Limit
requisições por minuto permitidas para esta chave
X-RateLimit-Remaining
requisições restantes na janela atual
X-RateLimit-Reset
segundos até a janela zerar

Uma chave digitada errado, desconhecida ou revogada nunca é ignorada: a requisição recebe 401 com WWW-Authenticate em vez de cair nos limites anônimos. A chave de uma conta banida recebe 403. Acima do limite, a resposta é 429 com Retry-After.

Especificação e arquivos legíveis por máquina

Licença

Guias, textos editoriais e os dados derivados próprios do site (estimativas do drop pool, RTP de caixas, índices, medianas diárias, tabelas de padrões, a compilação llms-catalog.txt) estão sob a licença CC BY 4.0: cite CS2Collections.net com um link para a página de origem.

Os dados de times e jogadores (/api/v1/teams, /api/v1/players) vêm da Liquipedia e estão sob a licença CC BY-SA 4.0: cite CS2Collections.net com um link e compartilhe adaptações sob a mesma licença.

O catálogo de itens (nomes, imagens, raridades e coleções dos arquivos do jogo via o conjunto de dados CSGO-API) e os preços dos mercados são dados de terceiros. Este site não declara licença sobre eles; valem os termos das fontes originais.

CC BY 4.0 ↗ · CC BY-SA 4.0 ↗

Como citar

Cite uma página como “CS2Collections.net — título da página, URL, data de atualização”, com a URL canônica e a data mostrada na página ou, se não houver, a data em que você a leu. Informe preços com moeda e horário: eles mudam.

CS2Collections.net — AK-47 | Redline, https://cs2collections.net/pt/items/ak-47-redline, 2026-09-27