Довідник Twitch Drops API
Безкоштовний JSON API з усіма активними кампаніями Twitch Drops і кампаніями з нагородами (оновлюються щохвилини), а також із глобальними значками чату Twitch. Звертайтеся до нього анонімно або з безкоштовним API-ключем: з ним ліміт вищий.
Спробувати
Маршрути
Кожен маршрут відповідає в JSON на запит GET, а браузери на будь-якому сайті можуть звертатися до API (CORS). Ні /drops, ні /rewards, ні /badges не потребують реєстрації; безкоштовний API-ключ підвищує ліміт на кожному з них.
Усі три маршрути відповідають однаково: список, час останнього отримання даних від Twitch (refreshedAt) і ваш ліміт запитів (rateLimit).
Автентифікація
Для читання /drops, /rewards і /badges не потрібні ні акаунт, ні ключ. Анонімні виклики рахуються за IP-адресою: 1 запит раз на 5 хв для кожного маршруту.
Ключі безкоштовні: увійдіть через Discord, Twitch або GitHub, створіть ключ в особистому кабінеті й передавайте його в заголовку X-API-Key. За замовчуванням ключ підвищує ваш ліміт до 1 запит за хвилину (більше — на запит) і показує ваш трафік.
Зберігайте ключ на своєму сервері: будь-хто, хто його прочитає, зможе витрачати ваш ліміт. Читайте його зі змінної середовища, а не прописуйте в коді.
Заголовок запиту
# 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Отримайте безкоштовний API-ключ
Ключ безкоштовний. Він підвищує ліміт з 1 запиту раз на 5 хв до 1 запит за хвилину для кожного маршруту, а в особистому кабінеті видно його трафік.
- Увійдіть через Discord, Twitch або GitHub: без пароля й без анкет.
- Відкрийте API-ключі в особистому кабінеті та створіть ключ із назвою вашого бота чи сайту.
- Скопіюйте ключ, коли його буде показано (лише один раз), і передавайте його в заголовку
X-API-Keyзі свого сервера.
Отримати кампанії Drops
Усі активні кампанії Drops, згруповані за іграми: один елемент games на гру, її кампанії в rewards, разом із часом останнього сканування Twitch і вашим лімітом запитів.
Тіло відповіді
Game
Поля DropCampaign, TimeBasedDrop і Benefit
DropCampaign
TimeBasedDrop
Benefit
Назви полів походять від Twitch і ніколи не змінюються: можуть зʼявлятися нові поля, наявні залишаються.
Коди відповіді
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" }}Отримати кампанії з нагородами
Усі активні кампанії з нагородами (події на всьому Twitch, значки для чату, нагороди партнерів) у campaigns, разом із часом останнього сканування Twitch і вашим лімітом запитів.
Тіло відповіді
RewardCampaign
Поля нагород
RewardGroup
Reward
Коди відповіді
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" }}Отримати значки чату
Глобальні значки чату Twitch у badges, по одному елементу на версію, у кожного спосіб отримання, якщо він відомий цьому API (requirement), разом із часом останнього отримання значків Twitch і вашим лімітом запитів.
Тіло відповіді
Badge
Поля BadgeRequirement
BadgeRequirement
Для майнерів Drops: залишайте значки, у яких requirement.watchTimeOnly дорівнює true. Їх видає кампанія Drops лише за час перегляду, ніколи за підписку. Перевіряйте також startAt і endAt: завершена кампанія залишається в списку.
Деякі значки вимагають більшого: з repeat дивіться requiredMinutes знову в кожному періоді, times разів, до endAt; зараховується будь-який канал в ефірі з categories; з collection скриня може дати не той значок, який вам потрібен (chestSize), а completeAll вимагає всієї колекції, включно з підписками. З evolvesFrom виберіть цей значок до перегляду.
Коди відповіді
curl https://drops.sunkwi.com/api/twitch/badgesЛіміти запитів
Кожен маршрут має власний лічильник: виклик /drops ніколи не витрачає ліміт /rewards чи /badges. Кампанії змінюються раз на хвилину, а значки раз на 5 хвилин, тож частіші запити нічого нового не дадуть.
Заголовки відповіді
Відхилений виклик (429) теж зараховується: дочекайтеся 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" }Помилки
Помилки повертають тіло JSON зі стабільним кодом: { "code": "RATE_LIMITED" }. Коди ніколи не змінюються: спирайтеся на code, а не на текст повідомлення.
HTTP/1.1 404 Not Foundcontent-type: application/json; charset=utf-8
{ "code": "NOT_FOUND" }Від сайту до API
Усі сторінки цього сайту читають ці самі маршрути. Тут показано, де у відповідях міститься те, що показує сторінка.
Адреса сторінки гри утворюється з назви гри (Rocket League → /drops/rocket-league). Це адреса цього сайту, а не поле API: зіставляйте ігри за gameId.