Reference Twitch Drops API
Bezplatné JSON API se všemi aktivními kampaněmi Twitch Drops a kampaněmi s odměnami, obnovované každou minutu, a s globálními odznaky do chatu na Twitchi. Volej ho anonymně, nebo s bezplatným klíčem API pro vyšší limit.
Vyzkoušej si to
Endpointy
Každý endpoint odpovídá na požadavek GET ve formátu JSON a API mohou volat prohlížeče z jakéhokoli webu (CORS). Ani /drops, ani /rewards, ani /badges nevyžadují registraci; bezplatný klíč API zvyšuje limit na každém z nich.
Všechny tři endpointy odpovídají stejně: seznam, čas posledního načtení z Twitche (refreshedAt) a tvůj limit požadavků (rateLimit).
Ověřování
Čtení /drops, /rewards a /badges nevyžaduje účet ani klíč. Anonymní volání se počítají podle IP adresy: 1 požadavek za 5 min na každém endpointu.
Klíče jsou zdarma: přihlas se přes Discord, Twitch nebo GitHub, vytvoř klíč na nástěnce a posílej ho v hlavičce X-API-Key. Klíč ve výchozím stavu zvýší tvůj limit na 1 požadavek za minutu, na požádání i víc, a ukazuje tvůj provoz.
Klíč měj na svém serveru: kdo ho přečte, může čerpat tvůj limit. Načítej ho z proměnné prostředí, nepiš ho přímo do kódu.
Hlavička požadavku
# 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/dropsZískej bezplatný klíč API
Klíč je zdarma. Zvýší tvůj limit z 1 požadavku za 5 min na 1 požadavek za minutu na každém endpointu a nástěnka ukazuje jeho provoz.
- Přihlas se přes Discord, Twitch nebo GitHub: žádné heslo, žádný formulář.
- Na nástěnce otevři Klíče API a vytvoř klíč pojmenovaný podle svého bota nebo webu.
- Zkopíruj klíč, až se zobrazí (jen jednou), a posílej ho v hlavičce
X-API-Keyze svého serveru.
Získat kampaně Drops
Všechny aktivní kampaně Drops seskupené podle her: jedna položka games na hru, její kampaně v rewards, spolu s časem poslední kontroly Twitche a tvým limitem požadavků.
Tělo odpovědi
Game
Pole DropCampaign, TimeBasedDrop a Benefit
DropCampaign
TimeBasedDrop
Benefit
Názvy polí pocházejí z Twitche a nikdy se nemění: mohou přibýt nová pole, stávající zůstanou.
Kódy odpovědí
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" }}Získat kampaně s odměnami
Všechny aktivní kampaně s odměnami (události na celém Twitchi, odznaky do chatu, odměny partnerů) v campaigns, spolu s časem poslední kontroly Twitche a tvým limitem požadavků.
Tělo odpovědi
RewardCampaign
Pole odměn
RewardGroup
Reward
Kódy odpovědí
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" }}Získat odznaky do chatu
Globální odznaky do chatu na Twitchi v badges, jedna položka na verzi, u každé způsob získání, pokud ho toto API zná (requirement), spolu s časem posledního načtení odznaků z Twitche a tvým limitem požadavků.
Tělo odpovědi
Badge
Pole BadgeRequirement
BadgeRequirement
Pro minery Drops: ponech si odznaky, jejichž requirement.watchTimeOnly je true. Pocházejí z kampaně Drops, která odznak dává jen za dobu sledování, nikdy za odběr. Kontroluj i startAt a endAt: skončená kampaň v seznamu zůstává.
Některé odznaky chtějí víc: s repeat sleduj requiredMinutes znovu v každém období, timeskrát, před endAt; počítá se kterýkoli živý kanál z categories; s collection může truhla dát jiný odznak, než chceš (chestSize), a completeAll vyžaduje celou kolekci, včetně odběrů. S evolvesFrom si před sledováním nasaď tento odznak.
Kódy odpovědí
curl https://drops.sunkwi.com/api/twitch/badgesLimity požadavků
Každý endpoint má vlastní počítadlo: volání /drops nikdy nečerpá limit /rewards ani /badges. Kampaně se mění jednou za minutu a odznaky každých 5 minut, takže častější dotazování nic nového nepřinese.
Hlavičky odpovědi
I odmítnuté volání (429) se počítá: před dalším pokusem počkej podle Retry-After.
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" }Chyby
Chyby vracejí tělo JSON se stálým kódem: { "code": "RATE_LIMITED" }. Kódy se nikdy nemění: spoléhej na code, ne na text zprávy.
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }Od webu k API
Každá stránka tohoto webu čte tytéž endpointy. Tady najdeš, kde v odpovědích leží to, co stránka zobrazuje.
Adresa stránky hry vzniká z názvu hry (Rocket League → /drops/rocket-league). Je to adresa tohoto webu, ne pole API: hry páruj podle gameId.