Referenz der Twitch Drops API
Eine kostenlose JSON-API mit allen aktiven Twitch-Drops- und Belohnungskampagnen, jede Minute aktualisiert, und den globalen Chat-Abzeichen von Twitch. Ruf sie anonym auf oder mit einem kostenlosen API-Schlüssel für ein höheres Limit.
Ausprobieren
Routen
Jede Route antwortet auf eine GET-Anfrage mit JSON, und Browser auf jeder Website können die API aufrufen (CORS). Weder /drops, /rewards noch /badges brauchen eine Registrierung; ein kostenloser API-Schlüssel erhöht das Limit bei jeder davon.
Die drei Routen antworten gleich: die Liste, die Uhrzeit des letzten Abrufs bei Twitch (refreshedAt) und dein Ratenlimit (rateLimit).
Authentifizierung
Zum Lesen von /drops, /rewards und /badges brauchst du weder Konto noch Schlüssel. Anonyme Aufrufe werden pro IP-Adresse gezählt: 1 Anfrage alle 5 Minuten pro Route.
Schlüssel sind kostenlos: Melde dich mit Discord, Twitch oder GitHub an, erstelle einen im Dashboard und sende ihn im Header X-API-Key. Ein Schlüssel hebt dein Limit standardmäßig auf 1 Anfrage pro Minute an, auf Anfrage auch höher, und zeigt dir deinen Traffic.
Behalte den Schlüssel auf deinem Server: Wer ihn liest, kann dein Limit verbrauchen. Lies ihn aus einer Umgebungsvariablen, statt ihn in deinen Code zu schreiben.
Anfrage-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/dropsKostenlosen API-Schlüssel holen
Ein Schlüssel ist kostenlos. Er hebt dein Limit von 1 Anfrage alle 5 Minuten auf 1 Anfrage pro Minute pro Route an, und dein Dashboard zeigt seinen Traffic.
- Melde dich mit Discord, Twitch oder GitHub an: kein Passwort, kein Formular.
- Öffne API-Schlüssel in deinem Dashboard und erstelle einen Schlüssel mit dem Namen deines Bots oder deiner Website.
- Kopiere den Schlüssel, sobald er angezeigt wird (nur einmal), und sende ihn von deinem Server im Header
X-API-Key.
Drops-Kampagnen abrufen
Alle aktiven Drops-Kampagnen, nach Spiel gruppiert: ein Eintrag von games pro Spiel, seine Kampagnen in rewards, zusammen mit der Uhrzeit des letzten Twitch-Scans und deinem Ratenlimit.
Antwort-Body
Game
Felder von DropCampaign, TimeBasedDrop und Benefit
DropCampaign
TimeBasedDrop
Benefit
Die Feldnamen stammen von Twitch und ändern sich nie: Neue Felder können hinzukommen, bestehende bleiben.
Antwortcodes
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" }}Belohnungskampagnen abrufen
Alle aktiven Belohnungskampagnen (Twitch-weite Events, Chat-Abzeichen, Partnerbelohnungen) in campaigns, zusammen mit der Uhrzeit des letzten Twitch-Scans und deinem Ratenlimit.
Antwort-Body
RewardCampaign
Felder der Belohnungen
RewardGroup
Reward
Antwortcodes
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" }}Chat-Abzeichen abrufen
Die globalen Chat-Abzeichen von Twitch in badges, ein Eintrag pro Version, jeweils mit dem Weg zum Abzeichen, sofern diese API ihn kennt (requirement), zusammen mit der Uhrzeit des letzten Abrufs der Twitch-Abzeichen und deinem Ratenlimit.
Antwort-Body
Badge
Felder von BadgeRequirement
BadgeRequirement
Für Drops-Miner: Behalte die Abzeichen, deren requirement.watchTimeOnly true ist. Sie stammen aus einer Drops-Kampagne, die das Abzeichen allein für Zuschauzeit vergibt, nie für ein Abo. Prüfe auch startAt und endAt: Eine beendete Kampagne bleibt in der Liste.
Manche Abzeichen verlangen mehr: Mit repeat schaust du requiredMinutes in jedem Zeitraum erneut zu, times-mal, vor endAt; jeder Live-Kanal der categories zählt; mit collection kann eine Truhe ein anderes Abzeichen als das gewünschte geben (chestSize), und completeAll verlangt die ganze Sammlung, Abos inklusive. Mit evolvesFrom legst du dieses Abzeichen vor dem Zuschauen an.
Antwortcodes
curl https://drops.sunkwi.com/api/twitch/badgesRatenlimits
Jede Route hat ihren eigenen Zähler: Ein Aufruf von /drops verbraucht nie das Kontingent von /rewards oder /badges. Die Kampagnen ändern sich einmal pro Minute und die Abzeichen alle 5 Minuten, häufigeres Abfragen bringt also nichts Neues.
Antwort-Header
Ein abgelehnter Aufruf (429) zählt trotzdem als Aufruf: Warte Retry-After ab, bevor du es erneut versuchst.
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" }Fehler
Fehler liefern einen JSON-Body mit einem festen Code: { "code": "RATE_LIMITED" }. Codes ändern sich nie: Verlass dich auf code, nicht auf eine Meldung.
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }Von der Website zur API
Jede Seite dieser Website liest dieselben Routen. Hier steht, wo das, was eine Seite zeigt, in den Antworten zu finden ist.
Die Adresse einer Spielseite ergibt sich aus dem Spielnamen (Rocket League → /drops/rocket-league). Sie ist eine Adresse dieser Website, kein Feld der API: Ordne Spiele über gameId zu.