Referencia de la Twitch Drops API
Una API JSON gratuita con todas las campañas de Twitch Drops y de recompensas activas, actualizada cada minuto, y los emblemas globales del chat de Twitch. Llámala de forma anónima o con una clave de API gratuita para tener un límite más alto.
Pruébala
Rutas
Todas las rutas responden en JSON a una solicitud GET, y los navegadores de cualquier sitio pueden llamar a la API (CORS). Ni /drops, ni /rewards ni /badges requieren registro; una clave de API gratuita sube el límite en cada una.
Las tres rutas responden igual: la lista, la hora de la última lectura de Twitch (refreshedAt) y tu límite de uso (rateLimit).
Autenticación
Para leer /drops, /rewards y /badges no necesitas cuenta ni clave. Las llamadas anónimas se cuentan por dirección IP: 1 solicitud cada 5 minutos en cada ruta.
Las claves son gratuitas: inicia sesión con Discord, Twitch o GitHub, crea una en el panel y envíala en el encabezado X-API-Key. Una clave sube tu límite a 1 solicitud por minuto de forma predeterminada (puedes pedir más) y te muestra tu tráfico.
Guarda la clave en tu servidor: cualquiera que la lea puede gastar tu límite. Léela de una variable de entorno en lugar de escribirla en tu código.
Encabezado de solicitud
# 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/dropsObtén una clave de API gratis
Una clave es gratuita. Sube tu límite de 1 solicitud cada 5 minutos a 1 solicitud por minuto en cada ruta, y tu panel muestra su tráfico.
- Inicia sesión con Discord, Twitch o GitHub: sin contraseña ni formularios.
- Abre Claves de API en tu panel y crea una clave con el nombre de tu bot o de tu sitio.
- Copia la clave cuando aparezca (solo una vez) y envíala en el encabezado
X-API-Keydesde tu servidor.
Obtener campañas de Drops
Todas las campañas de Drops activas, agrupadas por juego: un elemento de games por juego, con sus campañas en rewards, junto con la hora del último escaneo de Twitch y tu límite de uso.
Cuerpo de la respuesta
Game
Campos de DropCampaign, TimeBasedDrop y Benefit
DropCampaign
TimeBasedDrop
Benefit
Los nombres de los campos vienen de Twitch y nunca cambian: pueden aparecer campos nuevos, pero los existentes se mantienen.
Códigos de respuesta
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" }}Obtener campañas de recompensas
Todas las campañas de recompensas activas (eventos en todo Twitch, emblemas de chat, recompensas de socios) en campaigns, junto con la hora del último escaneo de Twitch y tu límite de uso.
Cuerpo de la respuesta
RewardCampaign
Campos de las recompensas
RewardGroup
Reward
Códigos de respuesta
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" }}Obtener emblemas del chat
Los emblemas globales del chat de Twitch en badges, un elemento por versión, cada uno con cómo conseguirlo cuando esta API lo sabe (requirement), junto con la hora de la última lectura de los emblemas de Twitch y tu límite de uso.
Cuerpo de la respuesta
Badge
Campos de BadgeRequirement
BadgeRequirement
Para los miners de Drops: quédate con los emblemas cuyo requirement.watchTimeOnly es true. Vienen de una campaña de Drops que da el emblema solo por tiempo de visualización, nunca por una suscripción. Revisa también startAt y endAt: una campaña terminada sigue en la lista.
Algunos emblemas piden más: con repeat, mira requiredMinutes de nuevo en cada período, times veces, antes de endAt; cuenta cualquier canal en vivo de categories; con collection, un cofre puede dar otro emblema distinto del que quieres (chestSize), y completeAll exige toda la colección, suscripciones incluidas. Con evolvesFrom, equipa ese emblema antes de ver.
Códigos de respuesta
curl https://drops.sunkwi.com/api/twitch/badgesLímites de uso
Cada ruta tiene su propio contador: llamar a /drops nunca gasta el cupo de /rewards ni el de /badges. Las campañas cambian una vez por minuto y los emblemas cada 5 minutos, así que consultar más seguido no aporta nada nuevo.
Encabezados de respuesta
Una llamada rechazada (429) también cuenta como llamada: espera lo que indique Retry-After antes de volver a intentarlo.
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" }Errores
Los errores llegan con un cuerpo JSON y un código estable: { "code": "RATE_LIMITED" }. Los códigos nunca cambian: guíate por code, no por un mensaje.
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }Del sitio a la API
Todas las páginas de este sitio leen estas mismas rutas. Aquí puedes ver en qué parte de las respuestas está lo que muestra cada página.
La dirección de la página de un juego sale de su nombre (Rocket League → /drops/rocket-league). Es una dirección de este sitio, no un campo de la API: identifica los juegos por gameId.