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.
| Endpoint | Retorna | Parâmetros |
|---|---|---|
GET /api/v1/inventory | Appraise a public CS2 Steam inventory | steam*lang |
GET /api/v1/inventories | Stored appraisals of up to 50 Steam inventories in one call (200 with an API key) | steam*lang |
GET /api/v1/price | Find CS2 items by name and get their current prices | q*lang |
GET /api/v1/price/history | Daily price history of one CS2 item | q*dayslang |
GET /api/v1/teams | Top CS2 teams by the official Valve ranking | region |
GET /api/v1/teams/{slug} | Team profile: roster, trophies, current events, recent matches, map stats and rank history | slug* |
GET /api/v1/players | Players of the ranked teams, optionally only those with a public Steam profile | steamlimit |
GET /api/v1/players/{slug} | Player of a ranked team | slug* |
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.
| Limite | Sem chave | Com chave |
|---|---|---|
| Requisições por minuto | 120 | 600 |
| Avaliações de inventário por hora | 60 | 300 |
| Perfis nunca avaliados por minuto | dentro do limite por hora | 30 |
| Perfis por chamada a /api/ | 50 | 200 |
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
/api/openapi.jsonespecificação OpenAPI 3.1: parâmetros, esquemas de resposta e erros/.well-known/openapi.jsona mesma especificação no endereço well-known/llms.txtvisão geral do site com padrões de URL e receitas de API para assistentes de IA/llms-full.txttodos os guias de texto em inglês em um único arquivo Markdown/llms-catalog.txttop 500 skins por valor de mercado listado em JSON Lines, atualizado a cada hora/.well-known/ai-catalog.jsonmanifesto de capacidades para agentes de IA- Metodologia de onde vêm os preços e como são calculados
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.
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