Twitch Drops APIリファレンス
開催中のすべてのTwitch Dropsと報酬キャンペーン(毎分更新)、そしてTwitchのグローバルチャットバッジを一覧できる無料のJSON APIです。匿名で呼び出すことも、無料のAPIキーで上限を引き上げることもできます。
試してみる
ルート
すべてのルートはGETリクエストにJSONで応答し、どのサイトのブラウザーからでもAPIを呼び出せます(CORS)。/drops、/rewards、/badgesのいずれも登録は不要で、無料のAPIキーがあればそれぞれの上限が上がります。
3つのルートはどれも同じ形で応答します。リスト、Twitchを最後に読み取った時刻(refreshedAt)、あなたのレート制限(rateLimit)です。
認証
/drops、/rewards、/badgesの読み取りにアカウントやキーは不要です。匿名の呼び出しはIPアドレスごとにカウントされ、上限は各ルートで5分に1リクエストです。
キーは無料です。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キーを取得
キーは無料です。各ルートの上限が5分に1リクエストから毎分1リクエストに引き上げられ、ダッシュボードでトラフィックを確認できます。
- Discord、Twitch、GitHubのいずれかでログインします。パスワードもフォーム入力も不要です。
- ダッシュボードでAPIキーを開き、ボットやサイトの名前を付けてキーを作成します。
- 表示されたキーをコピーし(表示は一度だけです)、サーバーから
X-API-Keyヘッダーで送信します。
Dropsキャンペーンを取得
開催中のすべてのDropsキャンペーンをゲームごとにまとめ、最新のTwitchスキャン時刻とあなたのレート制限を付けて返します。1ゲームにつきgamesの1項目で、キャンペーンはrewardsに入ります。
レスポンスボディ
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に入れて返します。1バージョンにつき1項目で、このAPIが把握している場合は入手方法(requirement)も付きます。Twitchのバッジを最後に読み取った時刻と、あなたのレート制限も含まれます。
レスポンスボディ
Badge
BadgeRequirementのフィールド
BadgeRequirement
Dropsマイナー向け:requirement.watchTimeOnlyがtrueのバッジだけを残してください。これらは、サブスクではなく視聴時間だけでバッジを配布するDropsキャンペーンのバッジです。startAtとendAtも確認してください。終了したキャンペーンもリストに残ります。
条件がさらに多いバッジもあります。repeatがあれば期間ごとにrequiredMinutesを再び視聴し、endAtまでにtimes回行います。categoriesのいずれのチャンネルの配信でも対象です。collectionがあれば、宝箱から目当てとは別のバッジが出ることがあり(chestSize)、completeAllはサブスクを含めコレクションのすべてが必要です。evolvesFromがあれば、視聴前にそのバッジを装備してください。
レスポンスコード
curl https://drops.sunkwi.com/api/twitch/badgesレート制限
ルートごとに独自のカウンターがあります。/dropsを呼び出しても/rewardsや/badgesの枠は消費されません。キャンペーンは1分に1回、バッジは5分ごとに更新されるため、それより頻繁にポーリングしても新しい情報は得られません。
レスポンスヘッダー
拒否された呼び出し(429)も1回としてカウントされます。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を使ってください。