Dokumentacja Twitch Drops API
Darmowe API JSON z listą wszystkich aktywnych kampanii Twitch Drops i kampanii z nagrodami, odświeżane co minutę, a także z globalnymi odznakami czatu Twitcha. Wywołuj je anonimowo lub z darmowym kluczem API, aby mieć wyższy limit.
Wypróbuj
Ścieżki
Każda ścieżka odpowiada w formacie JSON na zapytanie GET, a przeglądarki na dowolnej stronie mogą wywoływać API (CORS). Ani /drops, ani /rewards, ani /badges nie wymagają rejestracji; darmowy klucz API podnosi limit na każdej z nich.
Wszystkie trzy ścieżki odpowiadają tak samo: lista, czas ostatniego odczytu z Twitcha (refreshedAt) i twój limit zapytań (rateLimit).
Uwierzytelnianie
Odczyt /drops, /rewards i /badges nie wymaga konta ani klucza. Anonimowe wywołania są liczone według adresu IP: 1 zapytanie co 5 min na każdej ścieżce.
Klucze są darmowe: zaloguj się kontem Discord, Twitch lub GitHub, utwórz klucz w panelu i wysyłaj go w nagłówku X-API-Key. Klucz domyślnie podnosi twój limit do 1 zapytanie na minutę, na prośbę jeszcze wyżej, i pokazuje twój ruch.
Trzymaj klucz na swoim serwerze: każdy, kto go odczyta, może zużyć twój limit. Wczytuj go ze zmiennej środowiskowej, zamiast wpisywać go w kodzie.
Nagłówek zapytania
# 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/dropsZdobądź darmowy klucz API
Klucz jest darmowy. Podnosi twój limit z 1 zapytania co 5 min do 1 zapytanie na minutę na każdej ścieżce, a twój panel pokazuje jego ruch.
- Zaloguj się kontem Discord, Twitch lub GitHub: bez hasła, bez formularza.
- Otwórz Klucze API w swoim panelu i utwórz klucz nazwany tak jak twój bot lub strona.
- Skopiuj klucz, gdy się wyświetli (tylko raz), i wysyłaj go w nagłówku
X-API-Keyze swojego serwera.
Pobierz kampanie Drops
Wszystkie aktywne kampanie Drops pogrupowane według gier: jeden element games na grę, jej kampanie w rewards, razem z czasem ostatniego skanowania Twitcha i twoim limitem zapytań.
Treść odpowiedzi
Game
Pola DropCampaign, TimeBasedDrop i Benefit
DropCampaign
TimeBasedDrop
Benefit
Nazwy pól pochodzą z Twitcha i nigdy się nie zmieniają: mogą pojawić się nowe pola, istniejące zostają.
Kody odpowiedzi
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" }}Pobierz kampanie z nagrodami
Wszystkie aktywne kampanie z nagrodami (wydarzenia na całym Twitchu, odznaki czatu, nagrody partnerów) w campaigns, razem z czasem ostatniego skanowania Twitcha i twoim limitem zapytań.
Treść odpowiedzi
RewardCampaign
Pola nagród
RewardGroup
Reward
Kody odpowiedzi
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" }}Pobierz odznaki czatu
Globalne odznaki czatu Twitcha w badges, jeden element na wersję, każdy ze sposobem zdobycia, jeśli to API go zna (requirement), razem z czasem ostatniego odczytu odznak Twitcha i twoim limitem zapytań.
Treść odpowiedzi
Badge
Pola BadgeRequirement
BadgeRequirement
Dla minerów Drops: zostaw odznaki, których requirement.watchTimeOnly ma wartość true. Pochodzą z kampanii Drops, która przyznaje odznakę za sam czas oglądania, nigdy za subskrypcję. Sprawdź też startAt i endAt: zakończona kampania zostaje na liście.
Niektóre odznaki wymagają więcej: przy repeat oglądaj requiredMinutes ponownie w każdym okresie, times razy, przed endAt; liczy się każdy kanał na żywo z categories; przy collection skrzynia może dać inną odznakę niż chcesz (chestSize), a completeAll wymaga całej kolekcji, łącznie z subskrypcjami. Przy evolvesFrom ustaw tę odznakę przed oglądaniem.
Kody odpowiedzi
curl https://drops.sunkwi.com/api/twitch/badgesLimity zapytań
Każda ścieżka ma osobny licznik: wywołanie /drops nigdy nie zużywa puli /rewards ani /badges. Kampanie zmieniają się raz na minutę, a odznaki co 5 minut, więc częstsze odpytywanie nie da nic nowego.
Nagłówki odpowiedzi
Odrzucone wywołanie (429) też się liczy: przed ponowną próbą poczekaj tyle, ile podaje 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" }Błędy
Błędy zwracają treść JSON ze stałym kodem: { "code": "RATE_LIMITED" }. Kody nigdy się nie zmieniają: opieraj się na code, a nie na komunikacie.
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }Od strony do API
Każda strona tej witryny odczytuje te same ścieżki. Oto gdzie w odpowiedziach znajduje się to, co pokazuje dana strona.
Adres strony gry pochodzi od nazwy gry (Rocket League → /drops/rocket-league). To adres tej witryny, a nie pole API: dopasowuj gry po gameId.