Referensi Twitch Drops API
API JSON gratis yang mencantumkan setiap kampanye Twitch Drops dan kampanye hadiah yang aktif, diperbarui setiap menit, serta lencana obrolan global Twitch. Panggil secara anonim, atau dengan kunci API gratis untuk batas yang lebih tinggi.
Coba
Rute
Setiap rute merespons JSON untuk permintaan GET, dan browser dari situs mana pun dapat memanggil API (CORS). Baik /drops, /rewards, maupun /badges tidak memerlukan pendaftaran; kunci API gratis menaikkan batas pada masing-masing.
Ketiga rute merespons dengan cara yang sama: daftarnya, waktu pembacaan Twitch terakhir (refreshedAt), dan batas permintaan Anda (rateLimit).
Autentikasi
Membaca /drops, /rewards, dan /badges tidak memerlukan akun maupun kunci. Panggilan anonim dihitung per alamat IP: 1 permintaan setiap 5 menit di setiap rute.
Kunci itu gratis: masuk dengan Discord, Twitch, atau GitHub, buat kunci di dasbor, lalu kirim di header X-API-Key. Secara default, kunci menaikkan batas Anda menjadi 1 permintaan per menit, bisa dinaikkan lagi atas permintaan, dan menampilkan trafik Anda.
Simpan kunci di server Anda: siapa pun yang membacanya bisa menghabiskan batas Anda. Baca kunci dari variabel lingkungan, jangan menuliskannya di kode.
Header permintaan
# 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/dropsDapatkan kunci API gratis
Kunci itu gratis. Kunci menaikkan batas Anda dari 1 permintaan setiap 5 menit menjadi 1 permintaan per menit di setiap rute, dan dasbor Anda menampilkan trafiknya.
- Masuk dengan Discord, Twitch, atau GitHub: tanpa kata sandi, tanpa formulir.
- Buka Kunci API di dasbor Anda dan buat kunci yang dinamai sesuai bot atau situs Anda.
- Salin kunci saat ditampilkan (hanya sekali) dan kirim di header
X-API-Key, dari server Anda.
Ambil kampanye Drops
Setiap kampanye Drops yang aktif, dikelompokkan per game: satu item games per game, kampanyenya di rewards, disertai waktu pemindaian Twitch terakhir dan batas permintaan Anda.
Body respons
Game
Field DropCampaign, TimeBasedDrop, dan Benefit
DropCampaign
TimeBasedDrop
Benefit
Nama field berasal dari Twitch dan tidak pernah berubah: field baru bisa muncul, field yang sudah ada tetap ada.
Kode respons
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" }}Ambil kampanye hadiah
Setiap kampanye hadiah yang aktif (acara seluruh Twitch, lencana obrolan, hadiah mitra) di campaigns, disertai waktu pemindaian Twitch terakhir dan batas permintaan Anda.
Body respons
RewardCampaign
Field hadiah
RewardGroup
Reward
Kode respons
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" }}Ambil lencana obrolan
Lencana obrolan global Twitch di badges, satu item per versi, masing-masing dengan cara mendapatkannya jika API ini mengetahuinya (requirement), disertai waktu pembacaan lencana Twitch terakhir dan batas permintaan Anda.
Body respons
Badge
Field BadgeRequirement
BadgeRequirement
Untuk miner Drops: simpan lencana dengan requirement.watchTimeOnly bernilai true. Lencana itu berasal dari kampanye Drops yang memberikan lencana hanya untuk waktu menonton, tidak pernah untuk langganan. Periksa juga startAt dan endAt: kampanye yang sudah berakhir tetap ada di daftar.
Beberapa lencana meminta lebih: dengan repeat, tonton lagi requiredMinutes setiap periode, sebanyak times kali, sebelum endAt; saluran siaran langsung mana pun dari categories dihitung; dengan collection, peti bisa memberi lencana lain dari yang Anda inginkan (chestSize), dan completeAll meminta seluruh koleksi, termasuk langganan. Dengan evolvesFrom, pasang lencana itu sebelum menonton.
Kode respons
curl https://drops.sunkwi.com/api/twitch/badgesBatas permintaan
Setiap rute punya penghitungnya sendiri: memanggil /drops tidak pernah mengurangi kuota /rewards atau /badges. Kampanye berubah sekali per menit dan lencana setiap 5 menit, jadi polling lebih cepat tidak memberi data baru.
Header respons
Panggilan yang ditolak (429) tetap dihitung: tunggu sesuai Retry-After sebelum mencoba lagi.
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" }Error
Error merespons body JSON dengan kode yang stabil: { "code": "RATE_LIMITED" }. Kode tidak pernah berubah: andalkan code, bukan pesannya.
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }Dari situs ke API
Setiap halaman situs ini membaca rute-rute yang sama. Berikut letak data yang ditampilkan setiap halaman di dalam respons.
Alamat halaman game berasal dari nama game (Rocket League → /drops/rocket-league). Itu alamat situs ini, bukan field API: cocokkan game berdasarkan gameId.