Referência da Twitch Drops API
Uma API JSON gratuita que lista todas as campanhas de Twitch Drops e de recompensas ativas, atualizada a cada minuto, e os emblemas globais do chat da Twitch. Chame-a anonimamente ou com uma chave de API gratuita para ter um limite maior.
Experimente
Rotas
Toda rota responde em JSON a uma requisição GET, e navegadores de qualquer site podem chamar a API (CORS). Nem /drops, nem /rewards, nem /badges exigem cadastro; uma chave de API gratuita aumenta o limite em cada uma.
As três rotas respondem do mesmo jeito: a lista, o horário da última leitura da Twitch (refreshedAt) e seu limite de requisições (rateLimit).
Autenticação
A leitura de /drops, /rewards e /badges não exige conta nem chave. Chamadas anônimas são contadas por endereço IP: 1 requisição a cada 5 minutos em cada rota.
As chaves são gratuitas: entre com Discord, Twitch ou GitHub, crie uma no painel e envie-a no cabeçalho X-API-Key. Uma chave aumenta seu limite para 1 requisição por minuto por padrão, ou mais sob pedido, e mostra seu tráfego.
Mantenha a chave no seu servidor: qualquer pessoa que a leia pode gastar seu limite. Leia a chave de uma variável de ambiente em vez de escrevê-la no código.
Cabeçalho da requisição
# Anonymouscurl https://drops.sunkwi.com/api/twitch/drops
# With an API key, showing the rate-limit headerscurl -i -H "x-api-key: $DROPS_API_KEY" https://drops.sunkwi.com/api/twitch/dropsObtenha uma chave de API gratuita
A chave é gratuita. Ela aumenta seu limite de 1 requisição a cada 5 minutos para 1 requisição por minuto em cada rota, e seu painel mostra o tráfego dela.
- Entre com Discord, Twitch ou GitHub: sem senha, sem formulário.
- Abra Chaves de API no seu painel e crie uma chave com o nome do seu bot ou site.
- Copie a chave quando ela aparecer (só uma vez) e envie-a no cabeçalho
X-API-Key, a partir do seu servidor.
Obter campanhas de Drops
Todas as campanhas de Drops ativas, agrupadas por jogo: um item de games por jogo, com suas campanhas em rewards, junto com o horário da última verificação da Twitch e seu limite de requisições.
Corpo da resposta
Game
Campos de DropCampaign, TimeBasedDrop e Benefit
DropCampaign
TimeBasedDrop
Benefit
Os nomes dos campos vêm da Twitch e nunca mudam: novos campos podem aparecer, os existentes continuam.
Códigos de resposta
curl https://drops.sunkwi.com/api/twitch/drops{ "games": [ { "gameId": "460630", "gameDisplayName": "Rainbow Six Siege", "gameBoxArtURL": "https://static-cdn.jtvnw.net/ttv-boxart/460630-120x160.jpg", "startAt": "2026-10-17T05:00:00Z", "endAt": "2026-11-02T13:59:59.999Z", "rewards": [ { "id": "ef80b803-…", "name": "R6S S2 2026 19", "startAt": "2026-10-17T05:00:00Z", "endAt": "2026-11-02T13:59:59.999Z", "firstSeenAt": "2026-10-17T05:00:41.208Z", "accountLinkURL": "https://drops-register.ubi.com", "timeBasedDrops": [ { "name": "Esports Pack", "requiredMinutesWatched": 120, "repeat": null, "benefitEdges": [{ "benefit": { "name": "Esports Pack", … } }] } ], … } ] }, … ], "refreshedAt": "2026-10-24T21:14:01.936Z", "rateLimit": { "limit": 1, "remaining": 0, "resetAt": "2026-10-24T21:15:12.000Z" }}Obter campanhas de recompensas
Todas as campanhas de recompensas ativas (eventos em toda a Twitch, emblemas de chat, recompensas de parceiros) em campaigns, junto com o horário da última verificação da Twitch e seu limite de requisições.
Corpo da resposta
RewardCampaign
Campos de recompensas
RewardGroup
Reward
Códigos de resposta
curl https://drops.sunkwi.com/api/twitch/rewards{ "campaigns": [ { "id": "19f00aac-…", "name": "First Partners Collection", "brand": "Pokemon", "status": "ACTIVE", "startsAt": "2026-08-24T17:00:00Z", "endsAt": "2026-11-01T07:00:00Z", "firstSeenAt": null, "isSitewide": true, "unlockRequirements": { "minuteWatchedGoal": 20, "subsGoal": 0 }, "rewards": [{ "name": "Great Ball", "earnableUntil": "2026-11-01T07:00:00Z", … }] }, { "id": "b7669f9e-…", "name": "GTAVI Launch Celebration", "brand": "Rockstar Games", "status": "UPCOMING", "startsAt": "2026-11-18T11:00:00Z", "endsAt": "2026-12-01T07:59:59.999Z", "unlockRequirements": { "minuteWatchedGoal": 60, "subsGoal": 0 }, "rewardGroups": [ { "id": "6a0e…", "unlockRequirements": { "minuteWatchedGoal": 60, "subsGoal": 0 }, "repeat": { "everyHours": 24, "times": 6 }, "categories": [{ "id": "1867279146", "displayName": "Grand Theft Auto VI", "slug": "grand-theft-auto-vi" }], "rewards": [{ "name": "GTA DVD Chest", … }] }, … ], … }, … ], "refreshedAt": "2026-10-24T21:14:01.936Z", "rateLimit": { "limit": 1, "remaining": 0, "resetAt": "2026-10-24T21:15:12.000Z" }}Obter emblemas do chat
Os emblemas globais do chat da Twitch em badges, um item por versão, cada um com o jeito de ganhá-lo quando esta API sabe (requirement), junto com o horário da última leitura dos emblemas da Twitch e seu limite de requisições.
Corpo da resposta
Badge
Campos de BadgeRequirement
BadgeRequirement
Para mineradores de Drops: fique com os emblemas cujo requirement.watchTimeOnly é true. Eles vêm de uma campanha de Drops que dá o emblema só pelo tempo assistido, nunca por uma inscrição. Confira também startAt e endAt: uma campanha encerrada continua na lista.
Alguns emblemas pedem mais: com repeat, assista requiredMinutes de novo a cada período, times vezes, antes de endAt; qualquer canal ao vivo de categories conta; com collection, um baú pode dar outro emblema que não o que você quer (chestSize), e completeAll exige a coleção inteira, inscrições incluídas. Com evolvesFrom, equipe esse emblema antes de assistir.
Códigos de resposta
curl https://drops.sunkwi.com/api/twitch/badgesLimites de requisições
Cada rota tem seu próprio contador: chamar /drops nunca gasta a cota de /rewards nem a de /badges. As campanhas mudam uma vez por minuto e os emblemas a cada 5 minutos, então consultar com mais frequência não traz nada novo.
Cabeçalhos da resposta
Uma chamada recusada (429) também conta: espere o Retry-After antes de tentar de novo.
HTTP/1.1 429 Too Many Requestscontent-type: application/json; charset=utf-8retry-after: 214ratelimit-limit: 1ratelimit-remaining: 0ratelimit-reset: 214ratelimit-policy: 1;w=300
{ "code": "RATE_LIMITED" }Erros
Os erros respondem com um corpo JSON contendo um código estável: { "code": "RATE_LIMITED" }. Os códigos nunca mudam: baseie-se em code, não em uma mensagem.
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }Do site para a API
Todas as páginas deste site leem estas mesmas rotas. Veja onde fica, nas respostas, o que cada página mostra.
O endereço da página de um jogo vem do nome do jogo (Rocket League → /drops/rocket-league). É um endereço deste site, não um campo da API: identifique os jogos por gameId.