API pública para desenvolvedores
Uma API JSON gratuita e somente leitura: preços de CS2, Dota 2, Rust e TF2, análises e índice do mercado de CS2, estimativas de inventários Steam com totais por jogo disponíveis, times e jogadores de CS2. A maioria dos métodos exige uma chave API pessoal gratuita, que também aumenta os limites; o índice do mercado e as consultas de float funcionam sem ela. Os parâmetros e dados suportados estão listados abaixo.
Suas skins. Preços sob controle.
Salve itens de CS2, acompanhe mudanças de preço e compare mercados diretamente no Steam.
Acesso à API e limites pessoais
Sem chave
O índice do mercado e as consultas de float funcionam sem fazer login: 5 requisições por minuto por endereço IP. Preços, ofertas, estado dos dados, drop pool, times, jogadores e inventários exigem uma chave.
EndpointsCom chave
Uma chave pessoal gratuita para scripts e integrações. Dá acesso a preços, ofertas, estado dos dados, drop pool, times, jogadores e inventários, e aumenta os limites, contabilizados separadamente para cada chave.
Como obter uma chave| Limite | Sem chave | Com chave |
|---|---|---|
| Requisições por minuto | 5 | 120 |
| Requisições de inventário por hora: individuais e em lote | Chave necessária | 240 |
| Primeiras consultas de inventário por minuto | Chave necessária | 24 |
| Perfis por chamada a /api/ | Chave necessária | 100 |
| Consultas ao coordenador de jogo por minuto em /api/ | 10 | 15 |
A cota horária de inventário abrange os dois métodos; um lote conta como uma requisição. Um inventário individual retornado com stale: true não consome essa cota. As primeiras consultas são de perfis sem avaliação salva.
Todas as chaves usadas a partir do mesmo endereço IP compartilham um limite comum, seja qual for a conta: 240 requisições por minuto, 480 requisições de inventário por hora, 48 primeiras consultas e 30 consultas ao coordenador de jogo por minuto.
Como obter uma chave
- Entre pela Steam e abra a seção “Chaves de API” do seu perfil. Ir para o perfil
- Crie chaves 5 minutos após se cadastrar no Skinory. Cada conta pode ter até 3 chaves ativas, cada uma com um nome.
- 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.
Cabeçalhos de resposta e erros
- X-RateLimit-Limit
- cota de requisições por minuto
- 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.
Exemplos de requisições
Preços com chave
curl -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/price?q=AK-47%20%7C%20Redline"Um inventário com chave
Envie um SteamID64, URL de perfil ou nome personalizado para /api/v1/inventory. O inventário deve ser público. A requisição pode esperar até 25 s, retornar uma avaliação salva (stale: true) ou responder 503 com Retry-After. checkedAt indica quando a avaliação foi feita.
curl --include -H "Authorization: Bearer $SKINORY_API_KEY" \
"https://skinory.io/api/v1/inventory?steam=76561197960287930"Inventários salvos em lote
Envie até 100 SteamID64 ou URLs /profiles/, separados por vírgulas. /api/v1/inventories lê avaliações salvas sem consultar o Steam. cached indica uma avaliação salva; unknown, a ausência dela. Solicite uma avaliação por meio de /api/v1/inventory.
curl -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/inventories?steam=76561198132414056,76561197960287930"Todos os preços de TF2 em uma requisição
curl --compressed -H "X-Api-Key: $SKINORY_API_KEY" \
"https://skinory.io/api/v1/games/tf2/prices"429 indica que um limite da API foi atingido; 503 indica que a avaliação está pendente ou que o Steam está limitando temporariamente as solicitações. Aguarde todo o tempo indicado em Retry-After, em segundos, mesmo que ultrapasse um minuto, e não repita em paralelo as solicitações para o mesmo perfil.
Atualização dos preços
Os preços em /api/v1/price, /api/v1/offers e nos métodos de Dota 2, Rust e TF2 em /api/v1/games têm um atraso mínimo de 6 horas. Confira pricedAt, snapshotAt e stale: não são cotações em tempo real. Sem um snapshot atrasado disponível, a API responde 503 com Retry-After. As avaliações de inventário têm o próprio checkedAt.
Endpoints
Os métodos e parâmetros vêm do OpenAPI. Os parâmetros marcados com * são obrigatórios. Os esquemas completos de resposta estão na especificação.
| Endpoint | Retorna | Parâmetros |
|---|---|---|
GET /api/v1/droppool chave API | Drop pool semanal do CS2 monitorado | — |
GET /api/v1/status chave API | Horários de atualização dos feeds de preços e conjuntos de dados | — |
GET /api/v1/index | Índice de mercado CS2 atual e capitalização por categoria | lang |
GET /api/v1/index/history | Histórico diário do índice CS2 de uma categoria | categorydayslang |
GET /api/v1/inventory chave API | Avaliação de um inventário público do Steam: CS2, Dota 2, Rust e TF2 | steam*lang |
GET /api/v1/inventories chave API | Avaliações salvas de até 100 inventários do Steam por requisição | steam*lang |
GET /api/v1/price chave API | Pesquisa de itens CS2 por nome; preços com atraso mínimo de 6 horas | q*langcurrency |
GET /api/v1/price/history chave API | Histórico diário do preço de um item CS2 | q*dayslang |
GET /api/v1/offers chave API | Ofertas de mercados para um item CS2 com atraso mínimo de 6 horas | name*lang |
GET /api/v1/games/{game} chave API | Catálogo de Dota 2, Rust ou TF2: filtros e fontes de preço | game*lang |
GET /api/v1/games/{game}/items chave API | Itens de Dota 2, Rust ou TF2; preços com atraso mínimo de 6 horas | game*qnameheroraritytypequalityslotcategoryitemclasssortpagelimitlang |
GET /api/v1/games/{game}/items/{slug} chave API | Um item de Dota 2, Rust ou TF2 com ofertas de mercados, atraso mínimo de 6 horas | game*slug*lang |
GET /api/v1/games/{game}/prices chave API | Todos os preços de um jogo em uma resposta, atraso mínimo de 6 horas | game* |
GET /api/v1/float | Float, seed, adesivos e chaveiro de um item CS2 pelo link de inspeção | url*lang |
GET /api/v1/teams chave API | Times de CS2 no ranking oficial da Valve | region |
GET /api/v1/teams/{slug} chave API | Perfil do time: elenco, troféus, partidas e histórico no ranking | slug* |
GET /api/v1/players chave API | Jogadores dos times do ranking da Valve | steamlimit |
GET /api/v1/players/{slug} chave API | Perfil do jogador e time atual | slug* |
Acesso separado para assistentes de IA
Assistentes de IA reconhecidos podem consultar inventários sem chave. As cotas de requisições valem por IP; as primeiras consultas compartilham um orçamento entre todos os assistentes. Cada lote aceita até 50 perfis. Esses não são os limites da sua chave pessoal.
- Requisições por minuto para assistentes de IA conhecidos em /api/v1
- 120
- Requisições de inventário por hora e IP
- 120
- Consultas por minuto de perfis nunca avaliados, compartilhadas por todos os assistentes de IA
- 16
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.txtCS2: top 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 Skinory 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 Skinory com um link e compartilhe adaptações sob a mesma licença.
Os catálogos usam dados Steam e arquivos dos jogos, incluindo CSGO-API para CS2. Esses materiais e os preços dos mercados vêm de terceiros; valem as condições dos titulares originais.
Como citar
Cite uma página como “Skinory — 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.
Skinory — AK-47 | Redline, https://skinory.io/pt/items/ak-47-redline, 2026-11-11