Referens för Twitch Drops API
Ett gratis JSON-API som listar alla aktiva Twitch Drops- och belöningskampanjer, uppdaterat varje minut, och Twitchs globala chattbadges. Anropa det anonymt, eller med en gratis API-nyckel för en högre gräns.
Testa
Routes
Alla routes svarar med JSON på ett GET-anrop, och webbläsare på alla webbplatser kan anropa API:et (CORS). Varken /drops, /rewards eller /badges kräver registrering; en gratis API-nyckel höjer gränsen på var och en.
Alla tre routes svarar på samma sätt: listan, tiden för den senaste hämtningen från Twitch (refreshedAt) och din anropsgräns (rateLimit).
Autentisering
Att läsa /drops, /rewards och /badges kräver varken konto eller nyckel. Anonyma anrop räknas per IP-adress: 1 anrop per 5 min på varje route.
Nycklar är gratis: logga in med Discord, Twitch eller GitHub, skapa en i kontrollpanelen och skicka den i headern X-API-Key. En nyckel höjer din gräns till 1 anrop per minut som standard, mer på begäran, och visar din trafik.
Ha nyckeln på din server: alla som kan läsa den kan använda din gräns. Läs den från en miljövariabel i stället för att skriva den i koden.
Anropsheader
# 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/dropsSkaffa en gratis API-nyckel
En nyckel är gratis. Den höjer din gräns från 1 anrop per 5 min till 1 anrop per minut på varje route, och kontrollpanelen visar dess trafik.
- Logga in med Discord, Twitch eller GitHub: inget lösenord, inget formulär.
- Öppna API-nycklar i kontrollpanelen och skapa en nyckel som du döper efter din bot eller webbplats.
- Kopiera nyckeln när den visas (bara en gång) och skicka den i headern
X-API-Keyfrån din server.
Hämta Drops-kampanjer
Alla aktiva Drops-kampanjer, grupperade per spel: ett objekt i games per spel, med dess kampanjer i rewards, tillsammans med tiden för den senaste Twitch-skanningen och din anropsgräns.
Svarets body
Game
Fält i DropCampaign, TimeBasedDrop och Benefit
DropCampaign
TimeBasedDrop
Benefit
Fältnamnen kommer från Twitch och ändras aldrig: nya fält kan tillkomma, befintliga finns kvar.
Svarskoder
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" }}Hämta belöningskampanjer
Alla aktiva belöningskampanjer (evenemang på hela Twitch, chattbadges, partnerbelöningar) i campaigns, tillsammans med tiden för den senaste Twitch-skanningen och din anropsgräns.
Svarets body
RewardCampaign
Fält för belöningar
RewardGroup
Reward
Svarskoder
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" }}Hämta chattbadges
Twitchs globala chattbadges i badges, ett objekt per version, vart och ett med hur man får badgen när API:et vet det (requirement), samt tiden för den senaste hämtningen av Twitchs badges och din anropsgräns.
Svarets body
Badge
Fält i BadgeRequirement
BadgeRequirement
För Drops-miners: behåll de badges vars requirement.watchTimeOnly är true. De kommer från en Drops-kampanj som ger badgen enbart för tittartid, aldrig för en prenumeration. Kontrollera även startAt och endAt: en avslutad kampanj ligger kvar i listan.
Vissa badges kräver mer: med repeat tittar du requiredMinutes igen varje period, times gånger, före endAt; alla livekanaler i categories räknas; med collection kan en kista ge en annan badge än den du vill ha (chestSize), och completeAll kräver hela samlingen, prenumerationer inräknade. Med evolvesFrom väljer du den badgen innan du tittar.
Svarskoder
curl https://drops.sunkwi.com/api/twitch/badgesAnropsgränser
Varje route har en egen räknare: att anropa /drops drar aldrig från budgeten för /rewards eller /badges. Kampanjerna ändras en gång per minut och listan över badges var 5:e minut, så tätare anrop ger inget nytt.
Svarsheaders
Ett nekat anrop (429) räknas ändå: vänta enligt Retry-After innan du försöker 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" }Fel
Fel svarar med en JSON-body med en stabil kod: { "code": "RATE_LIMITED" }. Koderna ändras aldrig: bygg på code, inte på ett meddelande.
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }Från webbplatsen till API:et
Alla sidor på den här webbplatsen läser samma routes. Här ser du var det som en sida visar finns i svaren.
En spelsidas adress kommer från spelets namn (Rocket League → /drops/rocket-league). Det är en adress på den här webbplatsen, inte ett fält i API:et: matcha spel på gameId.