Referenca za Twitch Drops API
Besplatni JSON API sa svim aktivnim kampanjama Twitch Drops i kampanjama s nagradama, osvježenima svake minute, te s globalnim značkama za chat na Twitchu. Pozivaj ga anonimno ili s besplatnim API ključem za veći limit.
Isprobaj
Rute
Svaka ruta odgovara JSON-om na zahtjev GET, a preglednici s bilo koje stranice mogu pozivati API (CORS). Ni /drops, ni /rewards, ni /badges ne traže registraciju; besplatni API ključ diže limit na svakoj od njih.
Sve tri rute odgovaraju jednako: popis, vrijeme zadnjeg dohvaćanja s Twitcha (refreshedAt) i tvoj limit zahtjeva (rateLimit).
Autentifikacija
Za čitanje /drops, /rewards i /badges ne trebaš ni račun ni ključ. Anonimni pozivi broje se po IP adresi: 1 zahtjev u 5 min na svakoj ruti.
Ključevi su besplatni: prijavi se putem Discorda, Twitcha ili GitHuba, izradi ključ na nadzornoj ploči i šalji ga u zaglavlju X-API-Key. Ključ prema zadanim postavkama podiže tvoj limit na 1 zahtjev u minuti, na zahtjev i više, i prikazuje tvoj promet.
Drži ključ na svom poslužitelju: svatko tko ga pročita može trošiti tvoj limit. Čitaj ga iz varijable okruženja umjesto da ga upisuješ u kod.
Zaglavlje zahtjeva
# 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/dropsNabavi besplatni API ključ
Ključ je besplatan. Podiže tvoj limit s 1 zahtjeva u 5 min na 1 zahtjev u minuti na svakoj ruti, a nadzorna ploča prikazuje njegov promet.
- Prijavi se putem Discorda, Twitcha ili GitHuba: bez lozinke, bez obrasca.
- Na nadzornoj ploči otvori API ključevi i izradi ključ nazvan po svom botu ili stranici.
- Kopiraj ključ kad se prikaže (samo jednom) i šalji ga u zaglavlju
X-API-Keysa svog poslužitelja.
Dohvati kampanje Drops
Sve aktivne kampanje Drops grupirane po igrama: jedna stavka iz games po igri, njezine kampanje u rewards, uz vrijeme zadnje provjere Twitcha i tvoj limit zahtjeva.
Tijelo odgovora
Game
Polja DropCampaign, TimeBasedDrop i Benefit
DropCampaign
TimeBasedDrop
Benefit
Nazivi polja dolaze s Twitcha i nikad se ne mijenjaju: mogu se pojaviti nova polja, a postojeća ostaju.
Kodovi odgovora
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" }}Dohvati kampanje s nagradama
Sve aktivne kampanje s nagradama (događaji na cijelom Twitchu, značke za chat, nagrade partnera) u campaigns, uz vrijeme zadnje provjere Twitcha i tvoj limit zahtjeva.
Tijelo odgovora
RewardCampaign
Polja nagrada
RewardGroup
Reward
Kodovi odgovora
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" }}Dohvati značke za chat
Globalne značke za chat na Twitchu u badges, jedna stavka po verziji, svaka s načinom osvajanja kad ga ovaj API zna (requirement), uz vrijeme zadnjeg dohvaćanja znački s Twitcha i tvoj limit zahtjeva.
Tijelo odgovora
Badge
Polja BadgeRequirement
BadgeRequirement
Za minere Drops: zadrži značke čiji je requirement.watchTimeOnly true. Dolaze iz kampanje Drops koja značku daje samo za vrijeme gledanja, nikad za pretplatu. Provjeri i startAt i endAt: završena kampanja ostaje na popisu.
Neke značke traže više: uz repeat gledaj requiredMinutes ponovno u svakom razdoblju, times puta, prije endAt; računa se bilo koji kanal uživo iz categories; uz collection škrinja može dati drugu značku od željene (chestSize), a completeAll traži cijelu kolekciju, uključujući pretplate. Uz evolvesFrom prije gledanja odaberi tu značku.
Kodovi odgovora
curl https://drops.sunkwi.com/api/twitch/badgesOgraničenja zahtjeva
Svaka ruta ima vlastiti brojač: poziv /drops nikad ne troši limit /rewards ni /badges. Kampanje se mijenjaju jednom u minuti, a značke svakih 5 minuta, pa češće dohvaćanje ne donosi ništa novo.
Zaglavlja odgovora
I odbijeni poziv (429) se broji: prije novog pokušaja pričekaj koliko kaže 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" }Pogreške
Pogreške vraćaju JSON tijelo sa stalnim kodom: { "code": "RATE_LIMITED" }. Kodovi se nikad ne mijenjaju: oslanjaj se na code, a ne na tekst poruke.
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }Od stranice do API-ja
Sve stranice ovog weba čitaju ove iste rute. Evo gdje se u odgovorima nalazi ono što pojedina stranica prikazuje.
Adresa stranice igre nastaje iz naziva igre (Rocket League → /drops/rocket-league). To je adresa ovog weba, a ne polje API-ja: igre uparuj po gameId.