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.
Încearcă
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).
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.
Ține cheia pe serverul tău: oricine o citește îți poate consuma limita. Citește-o dintr-o variabilă de mediu în loc s-o scrii în cod.
Antet de cerere
# 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/dropsObț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.
- Conectează-te cu Discord, Twitch sau GitHub: fără parolă, fără formular.
- Deschide Chei API în panoul de control și creează o cheie cu numele botului sau al site-ului tău.
- 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
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
Game
Câmpurile DropCampaign, TimeBasedDrop și Benefit
DropCampaign
TimeBasedDrop
Benefit
Numele câmpurilor vin de la Twitch și nu se schimbă niciodată: pot apărea câmpuri noi, iar cele existente rămân.
Coduri de răspuns
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" }}Obține campaniile de recompense
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
RewardCampaign
Câmpurile recompenselor
RewardGroup
Reward
Coduri de răspuns
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" }}Obține insignele de chat
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
Badge
Câmpurile BadgeRequirement
BadgeRequirement
Pentru minerii de Drops: păstrează insignele al căror requirement.watchTimeOnly este true. Vin dintr-o campanie Drops care oferă insigna doar pentru timpul de vizionare, niciodată pentru un abonament. Verifică și startAt și endAt: o campanie încheiată rămâne în listă.
Unele insigne cer mai mult: cu repeat, vizionează requiredMinutes din nou în fiecare perioadă, de times ori, înainte de endAt; contează orice canal live din categories; cu collection, un cufăr poate da altă insignă decât cea dorită (chestSize), iar completeAll cere întreaga colecție, inclusiv abonamentele. Cu evolvesFrom, pune-ți acea insignă înainte de vizionare.
Coduri de răspuns
curl https://drops.sunkwi.com/api/twitch/badgesLimite 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.
Antete de răspuns
Un apel refuzat (429) contează totuși ca apel: așteaptă cât indică Retry-After înainte să încerci din nou.
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.
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ă.
Adresa paginii unui joc vine din numele jocului (Rocket League → /drops/rocket-league). Este o adresă a acestui site, nu un câmp al API-ului: identifică jocurile după gameId.