Twitch Drops API संदर्भ
एक मुफ़्त JSON API, जो हर चालू Twitch Drops और इनाम अभियान की सूची देता है, हर मिनट अपडेट होता है, और Twitch के ग्लोबल चैट बैज भी देता है। इसे अनाम रूप से कॉल करें, या ज़्यादा सीमा के लिए मुफ़्त API कुंजी के साथ।
आज़माएं
रूट
हर रूट GET अनुरोध का जवाब JSON में देता है, और किसी भी साइट के ब्राउज़र 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हेडर में भेजें।
Drops अभियान पाएं
हर चालू Drops अभियान, गेम के हिसाब से समूहित: हर गेम का 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
Drops माइनर के लिए: सिर्फ़ वे बैज रखें जिनका requirement.watchTimeOnly true है। वे ऐसे Drops अभियान से आते हैं जो बैज सिर्फ़ देखने के समय के लिए देता है, सब्सक्रिप्शन के लिए कभी नहीं। startAt और endAt भी जांचें: खत्म हुआ अभियान सूची में बना रहता है।
कुछ बैज के लिए ज़्यादा चाहिए: repeat हो तो हर अवधि में requiredMinutes दोबारा देखें, times बार, endAt से पहले; 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 से करें।