Referanse for Twitch Drops API
Et gratis JSON-API med alle aktive Twitch Drops- og belønningskampanjer, oppdatert hvert minutt, og Twitchs globale chattemerker. Kall det anonymt, eller med en gratis API-nøkkel for en høyere grense.
Prøv det
Ruter
Alle ruter svarer med JSON på en GET-forespørsel, og nettlesere på alle nettsteder kan kalle API-et (CORS). Verken /drops, /rewards eller /badges krever registrering; en gratis API-nøkkel hever grensen på hver av dem.
De tre rutene svarer på samme måte: listen, tidspunktet for den siste hentingen fra Twitch (refreshedAt) og forespørselsgrensen din (rateLimit).
Autentisering
Lesing av /drops, /rewards og /badges krever verken konto eller nøkkel. Anonyme kall telles per IP-adresse: 1 forespørsel hvert 5. minutt på hver rute.
Nøkler er gratis: logg inn med Discord, Twitch eller GitHub, opprett en i kontrollpanelet og send den i headeren X-API-Key. En nøkkel øker grensen din til 1 forespørsel per minutt som standard, mer på forespørsel, og viser trafikken din.
Hold nøkkelen på serveren din: alle som kan lese den, kan bruke av grensen din. Les den fra en miljøvariabel i stedet for å skrive den i koden.
Forespørselsheader
# 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økkel
En nøkkel er gratis. Den øker grensen din fra 1 forespørsel hvert 5. minutt til 1 forespørsel per minutt på hver rute, og kontrollpanelet viser trafikken.
- Logg inn med Discord, Twitch eller GitHub: ikke noe passord, ikke noe skjema.
- Åpne API-nøkler i kontrollpanelet og opprett en nøkkel oppkalt etter boten eller nettstedet ditt.
- Kopier nøkkelen når den vises (bare én gang), og send den i headeren
X-API-Keyfra serveren din.
Hent Drops-kampanjer
Alle aktive Drops-kampanjer, gruppert etter spill: ett element i games per spill, med kampanjene i rewards, sammen med tidspunktet for den siste Twitch-skanningen og forespørselsgrensen din.
Svarets body
Game
Felt i DropCampaign, TimeBasedDrop og Benefit
DropCampaign
TimeBasedDrop
Benefit
Feltnavnene kommer fra Twitch og endres aldri: nye felt kan komme til, eksisterende blir værende.
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ønningskampanjer
Alle aktive belønningskampanjer (arrangementer på hele Twitch, chattemerker, partnerbelønninger) i campaigns, sammen med tidspunktet for den siste Twitch-skanningen og forespørselsgrensen din.
Svarets body
RewardCampaign
Felt 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 chattemerker
Twitchs globale chattemerker i badges, ett element per versjon, hvert med hvordan man får det når API-et vet det (requirement), sammen med tidspunktet for den siste hentingen av Twitchs merker og forespørselsgrensen din.
Svarets body
Badge
Felt i BadgeRequirement
BadgeRequirement
For Drops-minere: behold merkene der requirement.watchTimeOnly er true. De kommer fra en Drops-kampanje som gir merket for seertid alene, aldri for et abonnement. Sjekk også startAt og endAt: en avsluttet kampanje blir værende i listen.
Noen merker krever mer: med repeat ser du requiredMinutes igjen hver periode, times ganger, før endAt; enhver direktesendt kanal i categories teller; med collection kan en kiste gi et annet merke enn det du vil ha (chestSize), og completeAll krever hele samlingen, abonnementer inkludert. Med evolvesFrom velger du det merket før du ser.
Svarkoder
curl https://drops.sunkwi.com/api/twitch/badgesForespørselsgrenser
Hver rute har sin egen teller: kall til /drops bruker aldri av budsjettet til /rewards eller /badges. Kampanjene endres én gang i minuttet og merkene hvert 5. minutt, så hyppigere spørringer gir ikke noe nytt.
Svarheadere
Et avvist kall (429) teller likevel: vent så lenge Retry-After sier før du prøver igjen.
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" }Feil
Feil svarer med en JSON-body med en fast kode: { "code": "RATE_LIMITED" }. Kodene endres aldri: bygg på code, ikke på en melding.
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }Fra nettstedet til API-et
Alle sidene på dette nettstedet leser de samme rutene. Her ser du hvor det en side viser, ligger i svarene.
Adressen til en spillside kommer fra spillnavnet (Rocket League → /drops/rocket-league). Det er en adresse på dette nettstedet, ikke et felt i API-et: match spill på gameId.