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