Référence de la Twitch Drops API
Une API JSON gratuite qui liste toutes les campagnes de Drops et de récompenses actives sur Twitch, actualisée chaque minute, ainsi que les badges de chat globaux de Twitch. Appelez-la anonymement, ou avec une clé API gratuite pour une limite plus élevée.
Essayer
Routes
Chaque route répond en JSON à une requête GET, et les navigateurs de n’importe quel site peuvent appeler l’API (CORS). Ni /drops, ni /rewards, ni /badges ne demandent d’inscription ; une clé API gratuite relève la limite sur chacune.
Les trois routes répondent de la même façon : la liste, l’heure de la dernière lecture de Twitch (refreshedAt) et votre limite de débit (rateLimit).
Authentification
La lecture de /drops, /rewards et /badges ne demande ni compte ni clé. Les appels anonymes sont comptés par adresse IP : 1 requête toutes les 5 minutes sur chaque route.
Les clés sont gratuites : connectez-vous avec Discord, Twitch ou GitHub, créez-en une dans le tableau de bord et envoyez-la dans l’en-tête X-API-Key. Une clé relève votre limite à 1 requête par minute par défaut, davantage sur demande, et affiche votre trafic.
Gardez la clé sur votre serveur : quiconque la lit peut consommer votre limite. Lisez-la depuis une variable d’environnement plutôt que de l’écrire dans votre code.
En-tête de requête
# 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/dropsObtenir une clé API gratuite
Une clé est gratuite. Elle fait passer votre limite de 1 requête toutes les 5 minutes à 1 requête par minute sur chaque route, et votre tableau de bord affiche son trafic.
- Connectez-vous avec Discord, Twitch ou GitHub : ni mot de passe, ni formulaire.
- Ouvrez Clés API dans votre tableau de bord et créez une clé au nom de votre bot ou de votre site.
- Copiez la clé quand elle s’affiche (une seule fois) et envoyez-la dans l’en-tête
X-API-Key, depuis votre serveur.
Obtenir les campagnes de Drops
Toutes les campagnes de Drops actives, regroupées par jeu : un élément de games par jeu, ses campagnes dans rewards, avec l’heure du dernier scan de Twitch et votre limite de débit.
Corps de la réponse
Game
Champs de DropCampaign, TimeBasedDrop et Benefit
DropCampaign
TimeBasedDrop
Benefit
Les noms de champs viennent de Twitch et ne changent jamais : de nouveaux champs peuvent apparaître, les existants restent.
Codes de réponse
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" }}Obtenir les campagnes de récompenses
Toutes les campagnes de récompenses actives (événements sur tout Twitch, badges de chat, récompenses partenaires) dans campaigns, avec l’heure du dernier scan de Twitch et votre limite de débit.
Corps de la réponse
RewardCampaign
Champs des récompenses
RewardGroup
Reward
Codes de réponse
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" }}Obtenir les badges de chat
Les badges de chat globaux de Twitch dans badges, un élément par version, chacun avec la façon de l’obtenir quand cette API la connaît (requirement), avec l’heure de la dernière lecture des badges de Twitch et votre limite de débit.
Corps de la réponse
Badge
Champs de BadgeRequirement
BadgeRequirement
Pour les miners de Drops : gardez les badges dont requirement.watchTimeOnly vaut true. Ils viennent d’une campagne de Drops qui donne le badge pour le seul temps de visionnage, jamais pour un abonnement. Vérifiez aussi startAt et endAt : une campagne terminée reste dans la liste.
Certains badges demandent plus : avec repeat, regardez de nouveau requiredMinutes à chaque période, times fois, avant endAt ; n’importe quelle chaîne en direct des categories compte ; avec collection, un coffre peut donner un autre badge que celui voulu (chestSize), et completeAll demande toute la collection, abonnements compris. Avec evolvesFrom, équipez ce badge avant de regarder.
Codes de réponse
curl https://drops.sunkwi.com/api/twitch/badgesLimites de débit
Chaque route a son propre compteur : appeler /drops n’entame jamais le quota de /rewards ni celui de /badges. Les campagnes changent une fois par minute et les badges toutes les 5 minutes : interroger plus souvent n’apporte rien de nouveau.
En-têtes de réponse
Un appel refusé (429) compte quand même comme un appel : attendez la durée de Retry-After avant de réessayer.
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" }Erreurs
Les erreurs renvoient un corps JSON avec un code stable : { "code": "RATE_LIMITED" }. Les codes ne changent jamais : appuyez-vous sur code, pas sur un message.
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }Du site à l’API
Chaque page de ce site lit ces mêmes routes. Voici où se trouve, dans les réponses, ce qu’affiche chaque page.
L’adresse d’une page de jeu vient du nom du jeu (Rocket League → /drops/rocket-league). C’est une adresse de ce site, pas un champ de l’API : identifiez les jeux par gameId.