Twitch Drops API reference
A free JSON API listing every active Twitch Drops and reward campaign, refreshed every minute, and Twitch's global chat badges. Call it anonymously, or with a free API key for a higher limit.
Try it
Routes
Every route answers JSON to a GET request, and browsers of any site can call the API (CORS). None of /drops, /rewards or /badges need sign-up; a free API key raises the limit on each.
The three routes answer the same way: the list, the time of the last read from Twitch (refreshedAt) and your rate limit (rateLimit).
Authentication
Reading /drops, /rewards and /badges needs no account and no key. Anonymous calls are counted per IP address: 1 request every 5 minutes on each route.
Keys are free: sign in with Discord, Twitch or GitHub, create one in the dashboard and send it in the X-API-Key header. A key raises your limit to 1 request per minute by default, raised on request, and shows your traffic.
Keep the key on your server: anyone who reads it can spend your limit. Read it from an environment variable rather than writing it in your code.
Request header
# 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/dropsGet a free API key
A key is free. It raises your limit from 1 request every 5 minutes to 1 request per minute on each route, and your dashboard shows its traffic.
- Sign in with Discord, Twitch or GitHub: no password, no form.
- Open API keys in your dashboard and create a key named after your bot or site.
- Copy the key when it is shown (only once) and send it in the
X-API-Keyheader, from your server.
Get Drops campaigns
Every active Drops campaign, grouped by game: one item of games per game, its campaigns in rewards, with the time of the last Twitch scan and your rate limit.
Response body
Game
DropCampaign, TimeBasedDrop and Benefit fields
DropCampaign
TimeBasedDrop
Benefit
Field names come from Twitch and never change: new fields may appear, existing ones stay.
Response codes
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" }}Get reward campaigns
Every active reward campaign (sitewide events, chat badges, partner rewards) in campaigns, with the time of the last Twitch scan and your rate limit.
Response body
RewardCampaign
Reward fields
RewardGroup
Reward
Response codes
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" }}Get chat badges
Twitch's global chat badges in badges, one item per version. Each one says how to get it when this API knows (requirement). With the time of the last read of Twitch's badges and your rate limit.
Response body
Badge
BadgeRequirement fields
BadgeRequirement
For Drops miners: keep the badges whose requirement.watchTimeOnly is true. They come from a Drops campaign that gives the badge for watch time alone, never for a subscription. Check startAt and endAt too: an ended campaign stays in the list.
Some badges ask more: with repeat, watch requiredMinutes again each period, times times, before endAt; any live channel of categories counts; with collection, a chest may give another badge than the one you want (chestSize), and completeAll takes the whole collection, subscriptions included. With evolvesFrom, equip that badge before watching.
Response codes
curl https://drops.sunkwi.com/api/twitch/badgesRate limits
Each route has its own counter: calling /drops never spends the budget of /rewards or /badges. The campaigns change once a minute and the badges every 5 minutes, so polling faster brings nothing new.
Response headers
A refused call (429) still counts as a call: wait for Retry-After before trying again.
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" }Errors
An error comes with a JSON body and a stable code: { "code": "RATE_LIMITED" }. Codes never change: build on code, not on a message.
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }From the site to the API
Every page of this site reads these same routes. Here is where the content of each page sits in the answers.
A game page address comes from the game name (Rocket League → /drops/rocket-league). It is an address of this site, not a field of the API: match games on gameId.