Referentie van de Twitch Drops API
Een gratis JSON-API met elke actieve Twitch Drops- en beloningscampagne, elke minuut ververst, en de globale chatbadges van Twitch. Roep hem anoniem aan, of met een gratis API-sleutel voor een hogere limiet.
Uitproberen
Routes
Elke route antwoordt met JSON op een GET-verzoek, en browsers van elke site kunnen de API aanroepen (CORS). Voor /drops, /rewards en /badges hoef je je niet te registreren; een gratis API-sleutel verhoogt de limiet op elk ervan.
De drie routes antwoorden op dezelfde manier: de lijst, het tijdstip waarop Twitch het laatst is uitgelezen (refreshedAt) en je verzoeklimiet (rateLimit).
Authenticatie
Voor /drops, /rewards en /badges heb je geen account en geen sleutel nodig. Anonieme aanroepen worden per IP-adres geteld: 1 verzoek per 5 minuten op elke route.
Sleutels zijn gratis: log in met Discord, Twitch of GitHub, maak er een aan in het dashboard en verstuur hem in de header X-API-Key. Een sleutel verhoogt je limiet standaard naar 1 verzoek per minuut, op aanvraag meer, en toont je verkeer.
Houd de sleutel op je server: iedereen die hem kan lezen, kan je limiet opmaken. Lees hem uit een omgevingsvariabele in plaats van hem in je code te zetten.
Verzoekheader
# 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/dropsGratis API-sleutel aanvragen
Een sleutel is gratis. Hij verhoogt je limiet van 1 verzoek per 5 minuten naar 1 verzoek per minuut op elke route, en je dashboard toont het verkeer.
- Log in met Discord, Twitch of GitHub: geen wachtwoord, geen formulier.
- Open API-sleutels in je dashboard en maak een sleutel aan met de naam van je bot of site.
- Kopieer de sleutel wanneer hij wordt getoond (maar één keer) en verstuur hem in de header
X-API-Key, vanaf je server.
Drops-campagnes ophalen
Elke actieve Drops-campagne, gegroepeerd per game: één item van games per game, met de campagnes in rewards, samen met het tijdstip van de laatste Twitch-scan en je verzoeklimiet.
Antwoordbody
Game
Velden van DropCampaign, TimeBasedDrop en Benefit
DropCampaign
TimeBasedDrop
Benefit
Veldnamen komen van Twitch en veranderen nooit: er kunnen nieuwe velden bijkomen, bestaande blijven.
Antwoordcodes
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" }}Beloningscampagnes ophalen
Elke actieve beloningscampagne (evenementen op heel Twitch, chatbadges, partnerbeloningen) in campaigns, samen met het tijdstip van de laatste Twitch-scan en je verzoeklimiet.
Antwoordbody
RewardCampaign
Velden van beloningen
RewardGroup
Reward
Antwoordcodes
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" }}Chatbadges ophalen
De globale chatbadges van Twitch in badges, één item per versie, elk met hoe je hem krijgt als deze API dat weet (requirement), samen met het tijdstip waarop de badges van Twitch het laatst zijn uitgelezen en je verzoeklimiet.
Antwoordbody
Badge
Velden van BadgeRequirement
BadgeRequirement
Voor Drops-miners: houd de badges waarvan requirement.watchTimeOnly true is. Ze komen uit een Drops-campagne die de badge alleen voor kijktijd geeft, nooit voor een abonnement. Controleer ook startAt en endAt: een afgelopen campagne blijft in de lijst.
Sommige badges vragen meer: met repeat kijk je requiredMinutes elke periode opnieuw, times keer, vóór endAt; elk livekanaal van categories telt; met collection kan een kist een andere badge geven dan je wilt (chestSize), en completeAll vraagt de hele collectie, abonnementen inbegrepen. Met evolvesFrom zet je die badge op vóór het kijken.
Antwoordcodes
curl https://drops.sunkwi.com/api/twitch/badgesVerzoeklimieten
Elke route heeft een eigen teller: /drops aanroepen gaat nooit af van het budget van /rewards of /badges. De campagnes veranderen één keer per minuut en de badges elke 5 minuten, dus vaker opvragen levert niets nieuws op.
Antwoordheaders
Een geweigerde aanroep (429) telt toch mee: wacht volgens Retry-After voordat je het opnieuw probeert.
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" }Fouten
Fouten antwoorden met een JSON-body met een vaste code: { "code": "RATE_LIMITED" }. Codes veranderen nooit: bouw op code, niet op een bericht.
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }Van de site naar de API
Elke pagina van deze site leest dezelfde routes. Hier zie je waar in de antwoorden staat wat een pagina toont.
Het adres van een gamepagina komt van de gamenaam (Rocket League → /drops/rocket-league). Het is een adres van deze site, geen veld van de API: koppel games op gameId.