Reference for Twitch Drops API
Et gratis JSON-API med alle aktive Twitch Drops- og belønningskampagner, opdateret hvert minut, og de globale chatbadges fra Twitch. Kald det anonymt eller med en gratis API-nøgle for en højere grænse.
Prøv det
Ruter
Alle ruter svarer med JSON på en GET-anmodning, og browsere på alle sites kan kalde API'et (CORS). Hverken /drops, /rewards eller /badges kræver tilmelding; en gratis API-nøgle hæver grænsen på hver af dem.
De tre ruter svarer på samme måde: listen, tidspunktet for den seneste hentning fra Twitch (refreshedAt) og din anmodningsgrænse (rateLimit).
Godkendelse
Læsning af /drops, /rewards og /badges kræver hverken konto eller nøgle. Anonyme kald tælles pr. IP-adresse: 1 anmodning hvert 5. minut på hver rute.
Nøgler er gratis: log ind med Discord, Twitch eller GitHub, opret en i kontrolpanelet, og send den i headeren X-API-Key. En nøgle hæver som standard din grænse til 1 anmodning pr. minut, mere efter anmodning, og viser din trafik.
Hold nøglen på din server: alle, der kan læse den, kan bruge af din grænse. Læs den fra en miljøvariabel i stedet for at skrive den i din kode.
Anmodningsheader
# 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/dropsFå en gratis API-nøgle
En nøgle er gratis. Den hæver din grænse fra 1 anmodning hvert 5. minut til 1 anmodning pr. minut på hver rute, og dit kontrolpanel viser dens trafik.
- Log ind med Discord, Twitch eller GitHub: ingen adgangskode, ingen formular.
- Åbn API-nøgler i dit kontrolpanel, og opret en nøgle, der er opkaldt efter din bot eller dit site.
- Kopiér nøglen, når den vises (kun én gang), og send den i headeren
X-API-Keyfra din server.
Hent Drops-kampagner
Alle aktive Drops-kampagner, grupperet efter spil: ét element i games pr. spil, med dets kampagner i rewards, sammen med tidspunktet for den seneste Twitch-scanning og din anmodningsgrænse.
Svarets body
Game
Felter i DropCampaign, TimeBasedDrop og Benefit
DropCampaign
TimeBasedDrop
Benefit
Feltnavnene kommer fra Twitch og ændres aldrig: nye felter kan komme til, eksisterende bliver.
Svarkoder
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" }}Hent belønningskampagner
Alle aktive belønningskampagner (begivenheder på hele Twitch, chatbadges, partnerbelønninger) i campaigns, sammen med tidspunktet for den seneste Twitch-scanning og din anmodningsgrænse.
Svarets body
RewardCampaign
Felter for belønninger
RewardGroup
Reward
Svarkoder
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" }}Hent chatbadges
De globale chatbadges fra Twitch i badges, ét element pr. version, hvert med, hvordan man får det, når dette API ved det (requirement), samt tidspunktet for den seneste hentning af badgene fra Twitch og din anmodningsgrænse.
Svarets body
Badge
Felter i BadgeRequirement
BadgeRequirement
Til Drops-minere: behold de badges, hvis requirement.watchTimeOnly er true. De kommer fra en Drops-kampagne, der giver badget for seertid alene, aldrig for et abonnement. Tjek også startAt og endAt: en afsluttet kampagne bliver på listen.
Nogle badges kræver mere: med repeat skal du se requiredMinutes igen i hver periode, times gange, før endAt; enhver livekanal i categories tæller; med collection kan en kiste give et andet badge end det, du vil have (chestSize), og completeAll kræver hele samlingen, abonnementer inklusive. Med evolvesFrom skal du vælge det badge, før du ser.
Svarkoder
curl https://drops.sunkwi.com/api/twitch/badgesAnmodningsgrænser
Hver rute har sin egen tæller: kald til /drops bruger aldrig af budgettet for /rewards eller /badges. Kampagnerne ændres én gang i minuttet og badgene hvert 5. minut, så hyppigere forespørgsler giver intet nyt.
Svarheaders
Et afvist kald (429) tæller stadig som et kald: vent på Retry-After, før du prøver igen.
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" }Fejl
Fejl svarer med en JSON-body med en fast kode: { "code": "RATE_LIMITED" }. Koderne ændres aldrig: byg på code, ikke på en besked.
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }Fra sitet til API'et
Alle sider på dette site læser de samme ruter. Her kan du se, hvor det, en side viser, findes i svarene.
En spilsides adresse kommer fra spillets navn (Rocket League → /drops/rocket-league). Det er en adresse på dette site, ikke et felt i API'et: match spil på gameId.