Twitch Drops API başvuru kılavuzu
Twitch'teki tüm etkin Drops ve ödül kampanyalarını listeleyen, her dakika yenilenen ve Twitch'in genel sohbet rozetlerini de sunan ücretsiz bir JSON API. Anonim olarak ya da daha yüksek bir limit için ücretsiz bir API anahtarıyla çağırın.
Deneyin
Rotalar
Her rota bir GET isteğine JSON ile yanıt verir ve her sitedeki tarayıcılar API'yi çağırabilir (CORS). Ne /drops, ne /rewards, ne de /badges kayıt gerektirir; ücretsiz bir API anahtarı her birinde limiti yükseltir.
Üç rota da aynı şekilde yanıt verir: liste, Twitch'ten yapılan son okumanın zamanı (refreshedAt) ve istek limitiniz (rateLimit).
Kimlik doğrulama
/drops, /rewards ve /badges rotalarını okumak için hesap da anahtar da gerekmez. Anonim çağrılar IP adresi başına sayılır: her rotada 5 dakikada 1 istek.
Anahtarlar ücretsizdir: Discord, Twitch veya GitHub ile giriş yapın, panelden bir anahtar oluşturun ve X-API-Key başlığında gönderin. Bir anahtar, limitinizi varsayılan olarak dakikada 1 istek düzeyine çıkarır (talep üzerine daha da artırılabilir) ve trafiğinizi gösterir.
Anahtarı sunucunuzda tutun: onu okuyan herkes limitinizi harcayabilir. Kodunuza yazmak yerine bir ortam değişkeninden okuyun.
İstek başlığı
# 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Ücretsiz API anahtarı al
Anahtar ücretsizdir. Her rotada limitinizi 5 dakikada 1 istekten dakikada 1 istek düzeyine çıkarır ve paneliniz anahtarın trafiğini gösterir.
- Discord, Twitch veya GitHub ile giriş yapın: şifre yok, form yok.
- Panelinizde API anahtarları bölümünü açın ve botunuzun veya sitenizin adını taşıyan bir anahtar oluşturun.
- Anahtar gösterildiğinde (yalnızca bir kez) kopyalayın ve sunucunuzdan
X-API-Keybaşlığında gönderin.
Drops kampanyalarını al
Oyuna göre gruplanmış tüm etkin Drops kampanyaları: oyun başına bir games öğesi, kampanyaları rewards içinde; yanında son Twitch taramasının zamanı ve istek limitiniz.
Yanıt gövdesi
Game
DropCampaign, TimeBasedDrop ve Benefit alanları
DropCampaign
TimeBasedDrop
Benefit
Alan adları Twitch'ten gelir ve asla değişmez: yeni alanlar eklenebilir, mevcut olanlar kalır.
Yanıt kodları
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" }}Ödül kampanyalarını al
Tüm etkin ödül kampanyaları (tüm Twitch'teki etkinlikler, sohbet rozetleri, iş ortağı ödülleri) campaigns içinde; yanında son Twitch taramasının zamanı ve istek limitiniz.
Yanıt gövdesi
RewardCampaign
Ödül alanları
RewardGroup
Reward
Yanıt kodları
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" }}Sohbet rozetlerini al
Twitch'in genel sohbet rozetleri badges içinde, sürüm başına bir öğe; bu API biliyorsa her birinin nasıl alınacağıyla (requirement), Twitch rozetlerinin son okunma zamanı ve istek limitinizle birlikte.
Yanıt gövdesi
Badge
BadgeRequirement alanları
BadgeRequirement
Drops toplayıcı programlar için: requirement.watchTimeOnly değeri true olan rozetleri tutun. Bunlar, rozeti asla abonelik için değil, yalnızca izleme süresi için veren bir Drops kampanyasından gelir. startAt ve endAt değerlerini de kontrol edin: sona eren bir kampanya listede kalır.
Bazı rozetler daha fazlasını ister: repeat varsa requiredMinutes süresini her dönemde yeniden izleyin, times kez, endAt öncesinde; categories içindeki her canlı kanal sayılır; collection varsa sandık istediğinizden farklı bir rozet verebilir (chestSize) ve completeAll abonelikler dahil tüm koleksiyonu ister. evolvesFrom varsa izlemeden önce o rozeti takın.
Yanıt kodları
curl https://drops.sunkwi.com/api/twitch/badgesİstek limitleri
Her rotanın kendi sayacı vardır: /drops rotasını çağırmak, /rewards veya /badges kotasından asla harcamaz. Kampanyalar dakikada bir, rozetler 5 dakikada bir değişir; bu yüzden daha sık sorgulamak yeni bir şey getirmez.
Yanıt başlıkları
Reddedilen bir çağrı (429) da sayılır: yeniden denemeden önce Retry-After süresi kadar bekleyin.
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" }Hatalar
Hatalar, sabit bir kod içeren bir JSON gövdesiyle döner: { "code": "RATE_LIMITED" }. Kodlar asla değişmez: mesaja değil, code alanına göre geliştirin.
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }Siteden API'ye
Bu sitenin her sayfası aynı rotaları okur. Bir sayfada gösterilenlerin yanıtlarda nerede bulunduğu aşağıda.
Bir oyun sayfasının adresi oyunun adından gelir (Rocket League → /drops/rocket-league). Bu, API'nin bir alanı değil, bu sitenin bir adresidir: oyunları gameId alanına göre eşleştirin.