Справочник 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.