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 las insignias 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 hace falta 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 la cabecera X-API-Key. Una clave sube tu límite a 1 solicitud por minuto por defecto, ampliable si lo pides, 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.
Cabecera 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/dropsConsigue 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 se muestre (solo una vez) y envíala en la cabecera
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, insignias 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 insignias del chat
Las insignias globales del chat de Twitch en badges, un elemento por versión, cada una con cómo conseguirla cuando esta API lo sabe (requirement), junto con la hora de la última lectura de las insignias 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 las insignias cuyo requirement.watchTimeOnly es true. Vienen de una campaña de Drops que da la insignia solo por tiempo de visualización, nunca por una suscripción. Comprueba también startAt y endAt: una campaña terminada sigue en la lista.
Algunas insignias piden más: con repeat, mira requiredMinutes de nuevo en cada periodo, times veces, antes de endAt; cuenta cualquier canal en directo de categories; con collection, un cofre puede dar otra insignia distinta de la que quieres (chestSize), y completeAll exige toda la colección, suscripciones incluidas. Con evolvesFrom, equipa esa insignia 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 las insignias cada 5 minutos, así que consultar más a menudo no aporta nada nuevo.
Cabeceras de respuesta
Una llamada rechazada (429) también cuenta como llamada: espera lo que indique Retry-After antes de reintentar.
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 devuelven un cuerpo JSON con un código estable: { "code": "RATE_LIMITED" }. Los códigos nunca cambian: básate en code, no en 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.