Salt la conținut
Twitch Drops API

Referința Twitch Drops API

Un API JSON gratuit care listează toate campaniile Twitch Drops și de recompense active, actualizate în fiecare minut, și insignele de chat globale ale Twitch. Apelează-l anonim sau cu o cheie API gratuită pentru o limită mai mare.

URL de bazăhttps://drops.sunkwi.com/api/twitch
Obține o cheie API gratuităCitește referința

Încearcă

Anonim: 1 cerere la fiecare 5 min pe rută. Cu cheie: 1 pe minut.

GET
Se încarcă previzualizarea…
Răsfoiește

Rute

Fiecare rută răspunde cu JSON la o cerere GET, iar browserele de pe orice site pot apela API-ul (CORS). Nici /drops, nici /rewards, nici /badges nu necesită înregistrare; o cheie API gratuită ridică limita pe fiecare dintre ele.

Cele trei rute răspund la fel: lista, ora ultimei citiri de pe Twitch (refreshedAt) și limita ta de cereri (rateLimit).

RutăDescriere
GET /dropsCampanii Drops pe jocuri. Toate campaniile Drops active, grupate pe jocuri, în games: un element pe joc, cu campaniile lui în rewards.
GET /rewardsCampanii de recompense. Toate campaniile de recompense active (evenimente pe tot Twitch-ul, insigne de chat, recompense de la parteneri), în campaigns.
GET /badgesInsigne de chat globale. Insignele de chat globale ale Twitch, un element pe versiune în badges, cu modul de obținere când este cunoscut.

Autentificare

Citirea /drops, /rewards și /badges nu necesită cont sau cheie. Apelurile anonime sunt numărate per adresă IP: 1 cerere la fiecare 5 min pe fiecare rută.

Cheile sunt gratuite: conectează-te cu Discord, Twitch sau GitHub, creează una în panoul de control și trimite-o în antetul X-API-Key. O cheie îți ridică limita la 1 cerere pe minut în mod implicit, mai mult la cerere, și îți arată traficul.

Antet de cerere

AntetValoareDescriere
X-API-Keyjdk_…Cheia ta API: opțională pe fiecare rută. O cheie necunoscută, revocată sau dezactivată nu este niciodată refuzată: apelul contează ca anonim, iar x-api-key-status: invalid semnalează asta.
Exemplu de cerere · curl
# 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/drops

Obține o cheie API gratuită

O cheie este gratuită. Îți ridică limita de la 1 cerere la fiecare 5 min la 1 cerere pe minut pe fiecare rută, iar panoul de control îi arată traficul.

  1. Conectează-te cu Discord, Twitch sau GitHub: fără parolă, fără formular.
  2. Deschide Chei API în panoul de control și creează o cheie cu numele botului sau al site-ului tău.
  3. Copiază cheia când e afișată (o singură dată) și trimite-o în antetul X-API-Key, de pe serverul tău.

Obține campaniile Drops

GEThttps://drops.sunkwi.com/api/twitch/drops

Toate campaniile Drops active, grupate pe jocuri: un element din games pe joc, cu campaniile lui în rewards, împreună cu ora ultimei scanări Twitch și limita ta de cereri.

Corpul răspunsului

CâmpTipDescriere
gamesGame[]Campaniile active, în ordinea ultimei scanări. Un array gol este un răspuns valid.
refreshedAtstring (ISO 8601) | nullOra ultimei scanări Twitch reușite, null înainte de prima.
rateLimit{ limit, remaining, resetAt }Limita ta pe această rută după acest apel, așa cum o arată anteturile ratelimit-*: limit cereri pe fereastră, remaining încă permise și resetAt, momentul în care limita revine complet (ISO 8601).

Game

Un element din games.

CâmpTipDescriere
gameIdstringID-ul Twitch al jocului.
gameDisplayNamestringNumele jocului.
gameBoxArtURLstring (URL)Coperta jocului, 120×160.
startAtstring (ISO 8601)Începutul celei mai timpurii campanii a jocului.
endAtstring (ISO 8601)Sfârșitul celei mai târzii campanii a jocului.
rewardsDropCampaign[]Campaniile Drops ale jocului.
Câmpurile DropCampaign, TimeBasedDrop și Benefit

DropCampaign

O campanie Drops, în rewards al unui joc.

CâmpTipDescriere
idstringID-ul Twitch al campaniei.
name, descriptionstringNumele și descrierea date de editor.
owner{ id, name }Editorul care derulează campania.
game{ id, displayName, slug }Jocul campaniei.
statusstringStarea pe Twitch, ACTIVE pentru o campanie în desfășurare.
startAt, endAtstring (ISO 8601)Perioada de desfășurare a campaniei.
imageURLstring (URL)Imaginea campaniei.
detailsURL, accountLinkURLstring (URL)Pagina de detalii și pagina de conectare a contului, de la editor.
allow{ isEnabled, channels? }Canalele care pot oferi Drops când isEnabled este true; altfel, orice canal care transmite jocul. displayName poate fi null sau poate lipsi.
timeBasedDropsTimeBasedDrop[]Drops obținute prin vizionare.
eventBasedDropsunknown[]Drops obținute prin evenimente, transmise așa cum vin de la Twitch.
firstSeenAtstring (ISO 8601) | nullCând a văzut acest API campania prima dată. O campanie care revine la mai puțin de o zi după ce a ieșit din listă își păstrează data. null pentru campaniile pe care API-ul le oferea deja când a apărut acest câmp.

TimeBasedDrop

O recompensă Drops obținută prin vizionare, în timeBasedDrops.

CâmpTipDescriere
id, namestringID-ul Twitch și numele recompensei.
startAt, endAtstring (ISO 8601)Perioada în care recompensa poate fi obținută.
requiredMinutesWatchednumberMinutele de vizionare necesare.
requiredSubsnumberAbonamentele necesare.
repeat{ everyHours, times } | nullAdăugat de acest API: cât de des se obține din nou Drop-ul, cu times (de câte ori) și everyHours (24: o dată pe zi; null când Twitch nu spune). requiredMinutesWatched este atunci timpul de vizionare al unei perioade. null pentru un Drop obținut o singură dată.
preconditionDropsunknownDrops de obținut mai întâi, transmise așa cum vin de la Twitch.
benefitEdges{ benefit: Benefit, entitlementLimit }[]Ce oferă recompensa și de câte ori poate fi revendicată.

Benefit

Un obiect în joc, în benefitEdges.

CâmpTipDescriere
id, namestringID-ul Twitch și numele obiectului.
imageAssetURLstring (URL)Imaginea obiectului.
createdAtstring (ISO 8601)Data creării obiectului pe Twitch.
distributionTypestringCum e livrat obiectul: DIRECT_ENTITLEMENT pentru un obiect în joc, BADGE pentru o insignă de chat.
entitlementLimitnumberDe câte ori poate fi revendicat obiectul.
isIosAvailablebooleanDacă obiectul poate fi revendicat pe iOS.
game, ownerOrganization{ id, name }Jocul și editorul obiectului.

Coduri de răspuns

StareDescriere
200Campaniile active. O listă goală este un răspuns valid.
304Nimic nu s-a schimbat de la ETag-ul trimis: păstrează-ți copia. Gratuit, nu se socotește în limita ta.
429RATE_LIMITED: Așteaptă secundele indicate de Retry-After.
429INVALID_API_KEY_RATE_LIMITED: Cheia nu este recunoscută, iar limita anonimă a adresei tale IP este consumată: corectează cheia.
503SERVICE_UNAVAILABLE: Nicio listă încărcată încă (imediat după o repornire a API-ului): reîncearcă după Retry-After. Gratuit, nu se socotește în limita ta.
Exemplu de cerere
curl https://drops.sunkwi.com/api/twitch/drops
Exemplu de răspuns · 200 OK
{  "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" }}

Obține campaniile de recompense

GEThttps://drops.sunkwi.com/api/twitch/rewards

Toate campaniile de recompense active (evenimente pe tot Twitch-ul, insigne de chat, recompense de la parteneri) în campaigns, împreună cu ora ultimei scanări Twitch și limita ta de cereri.

Corpul răspunsului

CâmpTipDescriere
campaignsRewardCampaign[]Campaniile active, în ordinea ultimei scanări. Un array gol este un răspuns valid.
refreshedAtstring (ISO 8601) | nullOra ultimei scanări Twitch reușite, null înainte de prima.
rateLimit{ limit, remaining, resetAt }Limita ta pe această rută după acest apel, așa cum o arată anteturile ratelimit-*: limit cereri pe fereastră, remaining încă permise și resetAt, momentul în care limita revine complet (ISO 8601).

RewardCampaign

Un element din campaigns.

CâmpTipDescriere
id, name, brandstringID-ul Twitch, numele și brandul campaniei.
statusstringStarea în momentul cererii, stabilită după date: UPCOMING înainte de startsAt, ACTIVE până la endsAt, apoi EXPIRED.
summary, instructionsstringTextele afișate de Twitch.
startsAt, endsAtstring (ISO 8601)Perioada de desfășurare a campaniei.
image{ image1xURL }Imaginea campaniei.
aboutURL, externalURLstring (URL)Pagina de ajutor și pagina externă a campaniei.
isSitewidebooleanDacă orice canal contează, nu doar cele ale unui joc.
game{ id, displayName, slug }?Jocul campaniei, când are unul.
rewardValueURLParamstringValoarea pe care Twitch o adaugă la linkurile de revendicare.
unlockRequirements{ minuteWatchedGoal, subsGoal }Minutele de vizionare și abonamentele necesare.
rewardGroupsRewardGroup[]?Recompense obținute câte un grup pe rând, fiecare grup cu propriul obiectiv: o recompensă pe zi înseamnă un grup pe zi. Doar când Twitch le trimite.
rewardsReward[]Recompensele campaniei, inclusiv cele din grupurile ei, fiecare o singură dată.
firstSeenAtstring (ISO 8601) | nullCând a văzut acest API campania prima dată. O campanie care revine la mai puțin de o zi după ce a ieșit din listă își păstrează data. null pentru campaniile pe care API-ul le oferea deja când a apărut acest câmp.
Câmpurile recompenselor

RewardGroup

Un grup de recompense dintr-o campanie de recompense, obținute împreună.

CâmpTipDescriere
idstringID-ul Twitch al grupului.
unlockRequirements{ minuteWatchedGoal, subsGoal, turboSubsGoal?, eventTriggerGoal? }Ce cere grupul. Twitch adaugă aici obiective Turbo și de eveniment.
repeat{ everyHours, times } | nullCât de des se obține din nou grupul, ca repeat al unui Drop: minuteWatchedGoal este atunci timpul de vizionare al unei perioade. null pentru un grup obținut o singură dată.
categories{ id, displayName, slug }[]Categoriile ale căror canale live contează, oricare dintre ele; gol când Twitch nu numește niciuna.
rewardsReward[]Recompensele grupului, listate și în rewards al campaniei.

Reward

O recompensă dintr-o campanie de recompense.

CâmpTipDescriere
id, namestringID-ul Twitch și numele recompensei.
bannerImage, thumbnailImage{ image1xURL }Imaginile recompensei.
earnableUntilstring (ISO 8601)Ultimul moment în care recompensa poate fi obținută.
redemptionInstructions, redemptionURLstringCum și unde revendici recompensa.

Coduri de răspuns

StareDescriere
200Campaniile active. O listă goală este un răspuns valid.
304Nimic nu s-a schimbat de la ETag-ul trimis: păstrează-ți copia. Gratuit, nu se socotește în limita ta.
429RATE_LIMITED: Așteaptă secundele indicate de Retry-After.
429INVALID_API_KEY_RATE_LIMITED: Cheia nu este recunoscută, iar limita anonimă a adresei tale IP este consumată: corectează cheia.
503SERVICE_UNAVAILABLE: Nicio listă încărcată încă (imediat după o repornire a API-ului): reîncearcă după Retry-After. Gratuit, nu se socotește în limita ta.
Exemplu de cerere
curl https://drops.sunkwi.com/api/twitch/rewards
Exemplu de răspuns · 200 OK
{  "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" }}

Obține insignele de chat

GEThttps://drops.sunkwi.com/api/twitch/badges

Insignele de chat globale ale Twitch în badges, un element pe versiune, fiecare cu modul de obținere când acest API îl cunoaște (requirement), împreună cu ora ultimei citiri a insignelor Twitch și limita ta de cereri.

Corpul răspunsului

CâmpTipDescriere
badgesBadge[]Insignele globale, un element pe versiune. Un array gol este un răspuns valid.
refreshedAtstring (ISO 8601) | nullOra ultimei citiri reușite a insignelor Twitch (la fiecare 5 minute), null înainte de prima.
rateLimit{ limit, remaining, resetAt }Limita ta pe această rută după acest apel, așa cum o arată anteturile ratelimit-*: limit cereri pe fereastră, remaining încă permise și resetAt, momentul în care limita revine complet (ISO 8601).

Badge

Un element din badges: o versiune a unei insigne de chat globale, așa cum o listează Twitch acum.

CâmpTipDescriere
setId, versionIdstringSetul de insigne și versiunea lui: împreună identifică o insignă (sub-gifter și 5).
title, descriptionstringNumele ei și descrierea Twitch, în engleză.
imageUrl1x, imageUrl2x, imageUrl4xstring (URL)Imaginea ei la 18, 36 și 72 de pixeli.
clickAction, clickUrlstring | nullCe face Twitch la clic pe insignă, și linkul aferent; null când Twitch nu oferă unul.
firstSeenAtstring (ISO 8601) | nullCând a văzut acest API insigna prima dată. O insignă care revine la mai mult de 7 zile după ce Twitch a eliminat-o primește o dată nouă; dacă revine mai devreme, își păstrează data veche. null pentru insignele existente deja la prima lui citire.
requirementBadgeRequirement | nullCum se obține; null când acest API nu știe.
Câmpurile BadgeRequirement

BadgeRequirement

Cum se obține o insignă: din campania Drops care o oferă (DROPS) sau din descrierea Twitch a unei insigne de abonat sau de vizionare (TWITCH_DESCRIPTION).

CâmpTipDescriere
source'DROPS' | 'TWITCH_DESCRIPTION'DROPS sau TWITCH_DESCRIPTION.
watchTimeOnlybooleantrue exact când e suficient să vizionezi: o campanie DROPS care cere timp de vizionare (requiredMinutes peste 0) și niciun abonament (requiredSubs 0).
requiredMinutes, requiredSubsnumberMinutele de vizionare și abonamentele sau abonamentele cadou necesare.
gameId, gameNamestringJocul: ID-ul lui Twitch (null când e necunoscut) și numele lui.
channels, channelCountstring[] (≤ 5), numberPrimele 5 canale care o oferă (loginuri) și câte sunt în total; 0: orice canal care transmite jocul.
startAt, endAtstring (ISO 8601) | nullPerioada de desfășurare a campaniei; null pentru TWITCH_DESCRIPTION. O campanie încheiată rămâne în listă.
campaignId, campaignNamestring | nullCampania Drops; null pentru TWITCH_DESCRIPTION.
repeat{ everyHours, times } | nullDoar DROPS: timpul de vizionare se cere din nou în fiecare perioadă, iar requiredMinutes este pentru o perioadă, cu times și everyHours (20 min pe zi timp de 3 zile: times 3, everyHours 24); altfel null.
categories{ id, name }[] (≤ 50)Doar DROPS: categoriile ale căror canale live contează, oricare dintre ele (id și name, cel mult 50); gameId și gameName sunt prima. Altfel gol.
collection{ chestSize, completeAll } | nullDoar DROPS: insigna este una dintre recompensele unei colecții de eveniment, campania. chestSize: iese dintr-un cufăr cu atâtea recompense, una pe cufăr, niciodată la alegere (null: oferită direct). completeAll: oferită pentru completarea întregii colecții, inclusiv abonamentele. Altfel null.
evolvesFrom{ setId, versionId } | nullDoar DROPS: insigna pe care trebuie s-o porți în chat înainte de vizionare, după setId și versionId din această listă: o evoluție Pokémon cere stadiul anterior (Pikachu: Pichu). Altfel null, sau când nu e cunoscută.

Coduri de răspuns

StareDescriere
200Insignele globale. O listă goală este un răspuns valid.
304Nimic nu s-a schimbat de la ETag-ul trimis: păstrează-ți copia. Gratuit, nu se socotește în limita ta.
429RATE_LIMITED: Așteaptă secundele indicate de Retry-After.
429INVALID_API_KEY_RATE_LIMITED: Cheia nu este recunoscută, iar limita anonimă a adresei tale IP este consumată: corectează cheia.
503SERVICE_UNAVAILABLE: Nicio listă încărcată încă (imediat după o repornire a API-ului): reîncearcă după Retry-After. Gratuit, nu se socotește în limita ta.
Exemplu de cerere
curl https://drops.sunkwi.com/api/twitch/badges
Se încarcă previzualizarea…

Limite de cereri

Fiecare rută are propriul contor: un apel la /drops nu consumă niciodată limita lui /rewards sau /badges. Campaniile se schimbă o dată pe minut, iar insignele la fiecare 5 minute, așa că interogările mai dese nu aduc nimic nou.

ApelantLimită pe rutăNumărat per
Anonim1 cerere la fiecare 5 minAdresă IP
Cu o cheie API1 cerere pe minut implicit, mai mult la cerereCheie API

Antete de răspuns

Antetele citite și trimise de API.

AntetDirecțieDescriere
x-last-updated-atresponseOra ultimei citiri reușite de pe Twitch: scanarea pentru /drops și /rewards, insignele pentru /badges.
x-refresh-interval-secondsresponseSecunde între două citiri de pe Twitch: cererile mai dese returnează aceleași date (60 pentru /drops și /rewards, 300 pentru /badges).
ratelimit-limitresponseCereri permise în fereastră, pentru această rută.
ratelimit-remainingresponseCereri rămase în fereastra curentă.
ratelimit-resetresponseSecunde până când o cerere este permisă din nou.
ratelimit-policyresponsePolitica, sub forma <limită>;w=<fereastră în secunde>.
retry-afterresponseSecunde de așteptat înainte de reîncercare, la un răspuns 429 sau 503.
x-api-keyrequestCheia ta API: opțională pe fiecare rută.
x-api-key-statusresponseinvalid când cheia trimisă este necunoscută, revocată sau dezactivată: apelul a contat ca anonim, în limita adresei tale IP.
etagresponseEticheta acestui răspuns. Trimite-o înapoi în If-None-Match: cât timp datele nu s-au schimbat, răspunsul este un 304 care nu se socotește în limita ta.
if-none-matchrequestETag-ul ultimului tău răspuns, opțional: o listă neschimbată răspunde 304 Not Modified, gratuit.
Un al doilea apel anonim în mai puțin de 5 min
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" }

Erori

Erorile returnează un corp JSON cu un cod stabil: { "code": "RATE_LIMITED" }. Codurile nu se schimbă niciodată: bazează-te pe code, nu pe textul mesajului.

StareCodDescriere
429RATE_LIMITEDPrea multe cereri pe această rută: așteaptă secundele indicate de Retry-After.
429INVALID_API_KEY_RATE_LIMITEDPrea multe cereri, iar antetul X-API-Key conține o cheie necunoscută, revocată sau dezactivată: apelul a contat ca anonim. Corectează cheia sau așteaptă secundele indicate de Retry-After.
503SERVICE_UNAVAILABLENicio listă încărcată încă (imediat după o repornire a API-ului). Nu se consumă nimic: reîncearcă după secundele indicate de Retry-After.
404NOT_FOUNDRuta nu există.
500INTERNAL_SERVER_ERROREroare de server: reîncearcă mai târziu.
Exemplu de eroare
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }

De la site la API

Fiecare pagină a acestui site citește aceleași rute. Iată unde se află în răspunsuri ce arată fiecare pagină.

PaginăRutăUnde în răspuns
Drops/drops/dropsgames: un element pe joc, cu campaniile lui în rewards. Vizualizarea grilă desenează startAt și endAt pentru fiecare campanie.
Pagina unui joc/drops/<game>/dropsUn element din games, identificat după gameId. Fiecare campanie este games[i].rewards[j]; recompensele ei sunt benefitEdges din timeBasedDrops, cu requiredMinutesWatched.
Recompense/rewards/rewardscampaigns: un element pe campanie de recompense, cu recompensele ei în rewards și cerințele în unlockRequirements.
Pagina unei campanii de recompense/rewards/<campaign>/rewardsUn element din campaigns, identificat după id; recompensele lui sunt în rewards.
Insigne/badges/badgesbadges: toate elementele, întâi cele cu requirement, cu modul de obținere. Vizualizarea grilă desenează requirement.startAt și requirement.endAt pentru fiecare insignă.
Pagina unei insigne/badges/<badge>/badgesUn element din badges, identificat după setId și versionId; „Cum se obține” corespunde câmpului său requirement.