Twitch Drops API 參考資料
免費的 JSON API,列出所有進行中的 Twitch 掉寶和獎勵活動(每分鐘更新),以及 Twitch 的通用聊天徽章。可以匿名呼叫,也可以使用免費的 API 金鑰取得更高的限額。
試用
路由
所有路由都以 JSON 回應 GET 請求,任何網站的瀏覽器都可以呼叫 API(CORS)。/drops、/rewards 和 /badges 都不需要註冊;免費的 API 金鑰可以提高每個路由的限額。
三個路由的回應方式相同:清單、最近一次讀取 Twitch 的時間(refreshedAt)以及您的速率限制(rateLimit)。
驗證
讀取 /drops、/rewards 和 /badges 都不需要帳號或金鑰。匿名呼叫依 IP 位址計數:每個路由每 5 分鐘 1 次請求。
金鑰免費:使用 Discord、Twitch 或 GitHub 登入,在儀表板中建立金鑰,並以 X-API-Key 標頭傳送。金鑰預設會將您的限額提高到每分鐘 1 次請求 次(可申請再提高),並讓您查看流量。
請將金鑰保存在您的伺服器上:任何讀到它的人都能消耗您的限額。請從環境變數讀取,不要直接寫在程式碼中。
請求標頭
# 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/drops取得免費 API 金鑰
金鑰免費。它會將每個路由的限額從每 5 分鐘 1 次請求提高到每分鐘 1 次請求 次,您還能在儀表板中查看其流量。
- 使用 Discord、Twitch 或 GitHub 登入:不需要密碼,也不用填寫表單。
- 在儀表板中開啟 API 金鑰,以您的機器人或網站名稱建立金鑰。
- 在金鑰顯示時複製它(只會顯示一次),並從您的伺服器以
X-API-Key標頭傳送。
取得掉寶活動
所有進行中的掉寶活動,依遊戲分組:每款遊戲是 games 中的一個項目,其活動位於 rewards 中,並附上最近一次 Twitch 掃描的時間和您的速率限制。
回應本文
Game
DropCampaign、TimeBasedDrop 和 Benefit 欄位
DropCampaign
TimeBasedDrop
Benefit
欄位名稱來自 Twitch,永遠不會改變:可能會新增欄位,現有欄位一律保留。
回應代碼
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" }}取得獎勵活動
所有進行中的獎勵活動(Twitch 全站活動、聊天徽章、合作夥伴獎勵)位於 campaigns 中,並附上最近一次 Twitch 掃描的時間和您的速率限制。
回應本文
RewardCampaign
獎勵欄位
RewardGroup
Reward
回應代碼
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" }}取得聊天徽章
Twitch 的通用聊天徽章位於 badges 中,每個版本一個項目;本 API 知道取得方式時會附上(requirement),並附上最近一次讀取 Twitch 徽章的時間和您的速率限制。
回應本文
Badge
BadgeRequirement 欄位
BadgeRequirement
給掉寶掛機工具:保留 requirement.watchTimeOnly 為 true 的徽章。它們來自只需觀看時間、不需訂閱就會發放徽章的掉寶活動。也請檢查 startAt 和 endAt:已結束的活動仍會留在清單中。
有些徽章要求更多:有 repeat 時,每個週期都要再次觀看 requiredMinutes,在 endAt 之前共 times 次;categories 中任何實況頻道都會計入;有 collection 時,寶箱可能開出您想要以外的徽章(chestSize),而 completeAll 需要完成整個系列,包括訂閱。有 evolvesFrom 時,請在觀看前配戴該徽章。
回應代碼
curl https://drops.sunkwi.com/api/twitch/badges速率限制
每個路由各自計數:呼叫 /drops 不會消耗 /rewards 或 /badges 的額度。活動每分鐘更新一次,徽章每 5 分鐘更新一次,更頻繁地輪詢也不會取得新內容。
回應標頭
被拒絕的呼叫(429)同樣會計數:請等待 Retry-After 指定的時間後再試。
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" }錯誤
錯誤會附帶 JSON 本文和固定的代碼:{ "code": "RATE_LIMITED" }。代碼永遠不會改變:請依據 code 處理,而不是訊息。
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }從網站到 API
本站的每個頁面都讀取這些路由。以下列出每個頁面的內容在回應中的位置。
遊戲頁面的網址由遊戲名稱產生(Rocket League → /drops/rocket-league)。這是本站的網址,不是 API 的欄位:請以 gameId 比對遊戲。