Twitch Drops API -viiteopas
Ilmainen JSON-API, joka listaa jokaisen aktiivisen Twitch Drops -kampanjan ja palkintokampanjan ja päivittyy minuutin välein, sekä Twitchin yleiset chattimerkit. Kutsu sitä anonyymisti tai ilmaisella API-avaimella, jolloin raja on korkeampi.
Kokeile
Reitit
Jokainen reitti vastaa GET-pyyntöön JSON-muodossa, ja minkä tahansa sivuston selaimet voivat lähettää pyyntöjä API:lle (CORS). Reitit /drops, /rewards ja /badges eivät vaadi rekisteröitymistä; ilmainen API-avain nostaa rajaa kullakin niistä.
Kaikki kolme reittiä vastaavat samalla tavalla: luettelo, viimeisimmän Twitch-haun ajankohta (refreshedAt) ja pyyntörajasi (rateLimit).
Todennus
Reittien /drops, /rewards ja /badges lukemiseen ei tarvita tiliä eikä avainta. Anonyymit kutsut lasketaan IP-osoitteittain: 1 pyyntö 5 minuutin välein kullakin reitillä.
Avaimet ovat ilmaisia: kirjaudu Discordilla, Twitchillä tai GitHubilla, luo avain hallintapaneelissa ja lähetä se otsakkeessa X-API-Key. Avain nostaa rajasi oletuksena 1 pyyntö pyyntöön minuutissa, pyynnöstä enemmän, ja näyttää liikenteesi.
Pidä avain palvelimellasi: kuka tahansa sen lukeva voi kuluttaa rajaasi. Lue se ympäristömuuttujasta sen sijaan, että kirjoittaisit sen koodiisi.
Pyynnön otsake
# 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/dropsHanki ilmainen API-avain
Avain on ilmainen. Se nostaa rajasi 1 pyynnöstä 5 minuutin välein 1 pyyntö pyyntöön minuutissa jokaisella reitillä, ja hallintapaneelisi näyttää sen liikenteen.
- Kirjaudu Discordilla, Twitchillä tai GitHubilla: ei salasanaa, ei lomaketta.
- Avaa hallintapaneelista API-avaimet ja luo avain, jonka nimeät bottisi tai sivustosi mukaan.
- Kopioi avain, kun se näytetään (vain kerran), ja lähetä se palvelimeltasi otsakkeessa
X-API-Key.
Hae Drops-kampanjat
Jokainen aktiivinen Drops-kampanja peleittäin ryhmiteltynä: yksi games-kohde peliä kohden ja sen kampanjat kentässä rewards, mukana viimeisimmän Twitch-tarkistuksen ajankohta ja pyyntörajasi.
Vastauksen runko
Game
DropCampaign-, TimeBasedDrop- ja Benefit-kentät
DropCampaign
TimeBasedDrop
Benefit
Kenttien nimet tulevat Twitchiltä eivätkä koskaan muutu: uusia kenttiä voi tulla, olemassa olevat säilyvät.
Vastauskoodit
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" }}Hae palkintokampanjat
Jokainen aktiivinen palkintokampanja (koko Twitchin tapahtumat, chattimerkit, kumppanipalkinnot) kentässä campaigns, mukana viimeisimmän Twitch-tarkistuksen ajankohta ja pyyntörajasi.
Vastauksen runko
RewardCampaign
Palkintojen kentät
RewardGroup
Reward
Vastauskoodit
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" }}Hae chattimerkit
Twitchin yleiset chattimerkit kentässä badges, yksi kohde versiota kohden, kussakin tieto sen saamisesta, kun tämä API tietää sen (requirement), sekä Twitchin merkkien viimeisimmän haun ajankohta ja pyyntörajasi.
Vastauksen runko
Badge
BadgeRequirement-kentät
BadgeRequirement
Drops-minereille: pidä merkit, joiden requirement.watchTimeOnly on true. Ne tulevat Drops-kampanjasta, joka antaa merkin pelkästä katseluajasta, ei koskaan tilauksesta. Tarkista myös startAt ja endAt: päättynyt kampanja pysyy luettelossa.
Jotkin merkit vaativat enemmän: kun on repeat, katso requiredMinutes uudelleen joka jaksossa, times kertaa, ennen endAt-aikaa; mikä tahansa categories-kategorioiden suora kanava lasketaan; kun on collection, arkku voi antaa eri merkin kuin haluamasi (chestSize), ja completeAll vaatii koko kokoelman, tilaukset mukaan lukien. Kun on evolvesFrom, valitse tämä merkki ennen katsomista.
Vastauskoodit
curl https://drops.sunkwi.com/api/twitch/badgesPyyntörajat
Jokaisella reitillä on oma laskurinsa: /drops-kutsut eivät koskaan kuluta reittien /rewards tai /badges kiintiötä. Kampanjat muuttuvat kerran minuutissa ja merkit 5 minuutin välein, joten tiheämpi kysely ei tuo mitään uutta.
Vastauksen otsakkeet
Hylätty kutsu (429) lasketaan silti kutsuksi: odota Retry-After-otsakkeen ilmoittama aika ennen uutta yritystä.
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" }Virheet
Virheet palauttavat JSON-rungon, jossa on pysyvä koodi: { "code": "RATE_LIMITED" }. Koodit eivät koskaan muutu: rakenna code-kentän varaan, älä viestin.
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }Sivusto ja API
Jokainen tämän sivuston sivu lukee näitä samoja reittejä. Tästä näet, missä kohtaa vastauksia sivulla näkyvä tieto on.
Pelisivun osoite muodostetaan pelin nimestä (Rocket League → /drops/rocket-league). Se on tämän sivuston osoite, ei API:n kenttä: tunnista pelit gameId-kentän perusteella.