Riferimento della Twitch Drops API
Un'API JSON gratuita che elenca ogni campagna Twitch Drops e di ricompense attiva, aggiornata ogni minuto, e i badge globali della chat di Twitch. Chiamala in forma anonima, o con una chiave API gratuita per un limite più alto.
Provala
Route
Ogni route risponde in JSON a una richiesta GET, e i browser di qualsiasi sito possono chiamare l'API (CORS). Né /drops, né /rewards, né /badges richiedono una registrazione; una chiave API gratuita alza il limite su ciascuna.
Le tre route rispondono allo stesso modo: l'elenco, l'ora dell'ultima lettura di Twitch (refreshedAt) e il tuo limite di richieste (rateLimit).
Autenticazione
La lettura di /drops, /rewards e /badges non richiede né account né chiave. Le chiamate anonime vengono conteggiate per indirizzo IP: 1 richiesta ogni 5 minuti su ogni route.
Le chiavi sono gratuite: accedi con Discord, Twitch o GitHub, creane una nella dashboard e inviala nell'header X-API-Key. Una chiave alza il tuo limite a 1 richiesta al minuto per impostazione predefinita, di più su richiesta, e mostra il tuo traffico.
Tieni la chiave sul tuo server: chiunque la legga può consumare il tuo limite. Leggila da una variabile d'ambiente invece di scriverla nel codice.
Header della richiesta
# 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/dropsOttieni una chiave API gratuita
Una chiave è gratuita. Alza il tuo limite da 1 richiesta ogni 5 minuti a 1 richiesta al minuto su ogni route, e la tua dashboard ne mostra il traffico.
- Accedi con Discord, Twitch o GitHub: nessuna password, nessun modulo.
- Apri Chiavi API nella tua dashboard e crea una chiave con il nome del tuo bot o sito.
- Copia la chiave quando viene mostrata (una sola volta) e inviala nell'header
X-API-Key, dal tuo server.
Ottieni le campagne Drops
Ogni campagna Drops attiva, raggruppata per gioco: un elemento di games per gioco, con le sue campagne in rewards, accompagnato dall'ora dell'ultima scansione di Twitch e dal tuo limite di richieste.
Corpo della risposta
Game
Campi di DropCampaign, TimeBasedDrop e Benefit
DropCampaign
TimeBasedDrop
Benefit
I nomi dei campi provengono da Twitch e non cambiano mai: possono comparire nuovi campi, quelli esistenti restano.
Codici di risposta
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" }}Ottieni le campagne di ricompense
Ogni campagna di ricompense attiva (eventi su tutta la piattaforma, badge della chat, ricompense dei partner) in campaigns, accompagnata dall'ora dell'ultima scansione di Twitch e dal tuo limite di richieste.
Corpo della risposta
RewardCampaign
Campi delle ricompense
RewardGroup
Reward
Codici di risposta
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" }}Ottieni i badge della chat
I badge globali della chat di Twitch in badges, un elemento per versione, ciascuno con il modo di ottenerlo quando questa API lo conosce (requirement), accompagnati dall'ora dell'ultima lettura dei badge di Twitch e dal tuo limite di richieste.
Corpo della risposta
Badge
Campi di BadgeRequirement
BadgeRequirement
Per i miner di Drops: tieni i badge il cui requirement.watchTimeOnly è true. Provengono da una campagna Drops che assegna il badge solo per il tempo di visione, mai per un abbonamento. Controlla anche startAt e endAt: una campagna terminata resta nell'elenco.
Alcuni badge chiedono di più: con repeat, guarda di nuovo requiredMinutes a ogni periodo, times volte, prima di endAt; conta qualsiasi canale in diretta di categories; con collection, uno scrigno può dare un badge diverso da quello che vuoi (chestSize), e completeAll richiede tutta la collezione, abbonamenti inclusi. Con evolvesFrom, equipaggia quel badge prima di guardare.
Codici di risposta
curl https://drops.sunkwi.com/api/twitch/badgesLimiti di richieste
Ogni route ha il suo contatore: chiamare /drops non consuma mai il budget di /rewards o di /badges. Le campagne cambiano una volta al minuto e i badge ogni 5 minuti, quindi interrogare l'API più spesso non porta nulla di nuovo.
Header della risposta
Una chiamata rifiutata (429) conta comunque come chiamata: attendi Retry-After prima di riprovare.
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" }Errori
Gli errori restituiscono un corpo JSON con un codice stabile: { "code": "RATE_LIMITED" }. I codici non cambiano mai: basati su code, non su un messaggio.
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }Dal sito all'API
Ogni pagina di questo sito legge queste stesse route. Ecco dove si trova, nelle risposte, ciò che mostra ogni pagina.
L'indirizzo di una pagina gioco deriva dal nome del gioco (Rocket League → /drops/rocket-league). È un indirizzo di questo sito, non un campo dell'API: identifica i giochi tramite gameId.