Twitch詳細API

Q: パートナーとアフィリエイトの違いは何ですか？

どちらもTwitchの収益化の段階です。is_affiliateはエントリー段階を示し、is_partnerはアフィリエイトの1段階上にあたる最上位のTwitchパートナーを示します。この段階は、スポンサー契約を検討する前に、そのチャンネルがどの程度実績を積んでいるかを手早く判断する目安になります。

Q: 配信者がまだ活動しているかどうかはどうすれば確認できますか？

直近の配信の開始日時を示すlast_broadcast_atを、last_broadcast_titleおよびlast_broadcast_gameとあわせて確認してください。is_live、current_viewers、stream_titleは呼び出した時点の状態のみを表すため、現在オフラインのチャンネルでも定期的に配信している場合があります。

POST

APIの稼働状況

24時間の稼働状況: 正常
24時間の平均応答時間: —

良好／正常
利用可能
制限あり
ほぼ停止

正常

過去24時間

過去30日間

Twitchチャンネルのプロフィール、PartnerまたはAffiliateのステータス、ライブ配信の詳細、前回の配信を取得します。最近の動画と人気クリップはデフォルトで含まれます。これらのセクションを除外するには、include_videosまたはinclude_clipsにブール値のfalseを設定します。収益、サブスクライバー名、非公開の分析データは公開されません。

Twitch Detailsは、usernameを指定してチャンネル1件を読み取り、プロフィール（表示名、自己紹介、アバター、バナー、フォロワー数、作成日）、パートナーかアフィリエイトか、配信中かどうかと現在のタイトル・ゲーム・視聴者数・開始時刻、直近の配信のタイトル・ゲーム・日時を返します。デフォルトでは最近の動画と人気クリップも追加されます。スポンサー、代理店、eスポーツチームが、配信者の審査、チャンネルが現在も活動しているかの確認、契約前のチャンネル比較に利用しています。

ライブ関連のフィールドは呼び出した時点の状態を示します。活動中の配信者と配信をやめた配信者を見分けるにはlast_broadcast_atを使います。動画やクリップを除外するには、include_videosまたはinclude_clipsにブール値のfalseを指定してください。文字列の'false'は使えません。ここで追加されるクリップは、期間を指定できるTwitch Clips機能とは対象期間が異なります。

料金は1,000リクエストあたり$1.39（1回あたり$0.001389）です。失敗した呼び出しと空の結果には課金されません。同期処理です。時間のかかるジョブでは、ボディに"mode": "async"を追加し、job_idを取得してポーリングしてください。

AIプロンプト

EveryInfraのTwitch 詳細エンドポイント（twitch/profile）を使ったデータ収集スクリプトの作成を手伝ってください。

エンドポイントの仕組み：
- リクエスト：ヘッダーにAuthorization: Bearer <API key>を指定して、https://api.everyinfra.com/api/v1/socialにPOSTします。APIキーは環境変数EVERYINFRA_API_KEYから読み込み、ハードコードしないでください。
- リクエストボディでplatformにtwitch、actionにprofileを指定し、パラメータはparamsの中に入れます。
- 必須パラメータ：
  - username: profileまたはclipsで使用するTwitchチャンネルのログイン名（ショートネーム）です。先頭に@を付けることもできます。twitch.tvの完全なURLは解析されません。
- 任意パラメータ：
  - include_clips: profileのレスポンスに厳選されたクリップ情報を含めるかどうかを示すブール値で、デフォルトはtrueです。対象期間は単体のclipsエンドポイントとは異なります。
  - include_videos: profileのレスポンスに最近の動画アーカイブ情報を含めるかどうかを示すブール値で、デフォルトはtrueです。このセクションを省くにはfalseを指定してください。文字列"false"は指定しないでください。
- 1つのオブジェクトを返します。主なフィールド: user_id、username、display_name、bio、url、avatar_url、banner_url、follower_count、is_partner、is_affiliate、is_live、current_viewers。フィールドは全部で21個です。一覧はhttps://api.everyinfra.com/api/v1/social/catalog?platform=twitchを参照してください。.
- リクエストボディの例：
{
  "platform": "twitch",
  "action": "profile",
  "params": {
    "username": "shroud"
  }
}
- 料金：1,000リクエストあたり$1.39。失敗時および結果が空の場合は課金されません。
- 対象が数十〜数百件ある場合は、ボディに"mode": "async"を追加します。すぐにjob_idが返されるので、GET https://api.everyinfra.com/api/v1/jobs/{job_id}をポーリングして結果を取得します。
- 422の場合は、エラーに含まれる推奨パラメータ名と指定可能な値を使ってリクエストを修正します。429または503の場合は、Retry-Afterの指定に従って待ってから再試行します。

コードを書く前に、必要な対象とその件数、必要なフィールド、希望する出力形式を私に質問してください。そのうえで、計画と概算費用を私に確認してください。

リクエストパラメータ

名前	場所	型	必須	デフォルト	説明
`Authorization`	header	`string`	はい	-	Bearerの後にAPIキーを続けます。APIキーはコンソールで作成してください。URLやコードリポジトリには絶対に含めないでください。
`platform`	body	`string`	はい	`twitch`	プラットフォームの識別子です。値は固定です。
`action`	body	`string`	はい	`profile`	機能の識別子です。値は固定です。
`username`	body.params	`string`	はい	-	profileまたはclipsで使用するTwitchチャンネルのログイン名（ショートネーム）です。先頭に@を付けることもできます。twitch.tvの完全なURLは解析されません。
`include_clips`	body.params	`boolean`	いいえ	-	profileのレスポンスに厳選されたクリップ情報を含めるかどうかを示すブール値で、デフォルトはtrueです。対象期間は単体のclipsエンドポイントとは異なります。
`include_videos`	body.params	`boolean`	いいえ	-	profileのレスポンスに最近の動画アーカイブ情報を含めるかどうかを示すブール値で、デフォルトはtrueです。このセクションを省くにはfalseを指定してください。文字列"false"は指定しないでください。

コードサンプル

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "twitch",
  "action": "profile",
  "params": {
    "username": "shroud"
  }
}'

OpenAPI定義（JSON）サンプルは環境変数EVERYINFRA_API_KEYからAPIキーを読み込みます。コピーしたコードにAPIキーが含まれることはありません。

レスポンス例

実際のレスポンス

September 26, 2026 at 08:56（UTC）に、上のコードサンプルのパラメータでこのAPIを呼び出して取得しました。resultsとcountはその呼び出しの実際のレスポンスから個人情報（名前、ハンドル、アバター、プロフィールリンク、連絡先）を削除したものです。id、billing、quotaは呼び出しごとに異なるため、構造のみを示しています。

json

{
  "id": "req_…",
  "platform": "twitch",
  "action": "profile",
  "results": {
    "user_id": "•••",
    "username": "shroud",
    "display_name": "shroud",
    "bio": "I'm back baby",
    "url": "https://www.twitch.tv/shroud",
    "avatar_url": "https://static-cdn.jtvnw.net/•••",
    "banner_url": "https://static-cdn.jtvnw.net/jtv_user_pictures/dbee25e8-55b7-4565-87f0-e9d4661dcc66-profile_banner-480.jpeg",
    "follower_count": 11293129,
    "is_partner": true,
    "is_affiliate": false,
    "is_live": false,
    "last_broadcast_title": "we are SAVED!",
    "last_broadcast_game": "WARDOGS",
    "last_broadcast_at": "2026-09-26T04:34:47.953850+00:00",
    "created_at": "2012-11-03T15:50:32.878470+00:00",
    "recent_videos": [
      {
        "id": "•••",
        "title": "we are SAVED!",
        "url": "https://www.twitch.tv/videos/2883804788",
        "view_count": 2687,
        "duration_seconds": 35971,
        "game": "WARDOGS",
        "created_at": "2026-09-25T18:35:12+00:00"
      },
      {
        "id": "•••",
        "title": "surely were saved..?",
        "url": "https://www.twitch.tv/videos/2882888067",
        "view_count": 252586,
        "duration_seconds": 28465,
        "game": "WARDOGS",
        "created_at": "2026-09-24T17:23:48+00:00"
      },
      {
        "id": "•••",
        "title": "playing till we get ddosed",
        "url": "https://www.twitch.tv/videos/2882056326",
        "view_count": 194144,
        "duration_seconds": 21413,
        "game": "WARDOGS",
        "created_at": "2026-09-23T17:50:24+00:00"
      }
    ],
    "top_clips": [
      {
        "id": "•••",
        "title": "wtf !!",
        "url": "https://www.twitch.tv/shroud/clip/SeductiveFurryPotCmonBruh--v2IUlxXQxpw8YUZ",
        "view_count": 2230,
        "duration_seconds": 39,
        "game": "Active Matter",
        "curator_username": "•••",
        "curator_name": "Taisseeer",
        "thumbnail_url": "https://static-cdn.jtvnw.net/twitch-video-assets/twitch-vap-video-assets-prod-us-west-2/f4e752a4-c4c1-42b9-a4a1-a7a28106a717/landscape/thumb/thumb-0000000000-1920x1080.jpg",
        "created_at": "2026-09-19T22:08:27+00:00"
      },
      {
        "id": "•••",
        "title": "Pilot Kill",
        "url": "https://www.twitch.tv/shroud/clip/BreakableAssiduousBulgogiUnSane-oAR-wxU-JuRMLxdl",
        "view_count": 1042,
        "duration_seconds": 21,
        "game": "WARDOGS",
        "curator_username": "•••",
        "curator_name": "primo11119",
        "thumbnail_url": "https://static-cdn.jtvnw.net/twitch-video-assets/twitch-vap-video-assets-prod-us-west-2/f45445b1-9e8c-4cfd-88b0-d6cbe5d00b61/landscape/thumb/thumb-0000000000-1920x1080.jpg",
        "created_at": "2026-09-21T18:00:52+00:00"
      },
      {
        "id": "•••",
        "title": "next level bush camper",
        "url": "https://www.twitch.tv/shroud/clip/VainCloudyHawkRiPepperonis-imxaRCvFhJlfVtvo",
        "view_count": 784,
        "duration_seconds": 60,
        "game": "WARDOGS",
        "curator_username": "•••",
        "curator_name": "Plot_C4",
        "thumbnail_url": "https://static-cdn.jtvnw.net/twitch-video-assets/twitch-vap-video-assets-prod-us-west-2/84be87c7-bea1-4ed5-b709-8fdcc5482baa/landscape/thumb/thumb-0000000000-1920x1080.jpg",
        "created_at": "2026-09-20T17:44:19+00:00"
      }
    ],
    "platform": "twitch"
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

レスポンスフィールド

業務データはresultsに含まれます。この表はレコードに含まれうるフィールドの一覧です。プラットフォームに表示されない値を作り出すことはありません。

フィールド	意味
`user_id`	プラットフォーム上でのユーザーの一意なIDです。
`username`	ユーザー名（@ハンドル）です。
`display_name`	表示名です。usernameとは異なる場合があります。
`bio`	アカウント自身が記載したプロフィール文です。改行や絵文字を含む場合があります。
`url`	プラットフォーム上のレコードへのリンクです。
`avatar_url`	アバター画像のリンクです。一部のプラットフォームでは、サイズ指定付きで有効期限が切れる可能性のあるCDNリンクが返されます。
`banner_url`	プラットフォーム上の意味のまま
`follower_count`	フォロワー数です。nullは0ではなく、非公開であることを示します。
`is_partner`	プラットフォーム上の意味のまま
`is_affiliate`	プラットフォーム上の意味のまま
`is_live`	プラットフォーム上の意味のまま
`current_viewers`	プラットフォーム上の意味のまま
`stream_title`	プラットフォーム上の意味のまま
`current_game`	プラットフォーム上の意味のまま
`stream_started_at`	プラットフォーム上の意味のまま
`last_broadcast_title`	プラットフォーム上の意味のまま
`last_broadcast_game`	プラットフォーム上の意味のまま
`last_broadcast_at`	プラットフォーム上の意味のまま
`created_at`	作成日時です。形式はposted_atと同じです。
`recent_videos`	最近公開された動画の一覧です。各動画にはタイトル、リンク、再生回数、再生時間などが含まれます。該当する動画がない場合は含まれません。
`top_clips`	プラットフォーム上の意味のまま
`platform`	取得元プラットフォームの識別子で、リクエストのplatformと同じです（例：xiaohongshu、tiktok）。

FAQ

`username`には何を指定しますか？

チャンネルのログイン名（twitch.tv/shroudの場合はshroud）を指定します。先頭の@はあってもなくてもかまいません。twitch.tvの完全なリンクは解析されないため、名前のみを渡してください。チャンネルに表示される名前はログイン名と異なる場合があります。usernameにはログイン名、display_nameには表示名が入ります。

パートナーとアフィリエイトの違いは何ですか？

どちらもTwitchの収益化の段階です。is_affiliateはエントリー段階を示し、is_partnerはアフィリエイトの1段階上にあたる最上位のTwitchパートナーを示します。この段階は、スポンサー契約を検討する前に、そのチャンネルがどの程度実績を積んでいるかを手早く判断する目安になります。

配信者がまだ活動しているかどうかはどうすれば確認できますか？

直近の配信の開始日時を示すlast_broadcast_atを、last_broadcast_titleおよびlast_broadcast_gameとあわせて確認してください。is_live、current_viewers、stream_titleは呼び出した時点の状態のみを表すため、現在オフラインのチャンネルでも定期的に配信している場合があります。

エラーと課金

401: キーが未指定か無効です。
402: 残高が不足しています。先にチャージしてください。
422: パラメータ名または値が無効です。エラーに含まれる候補を参考に修正してください。課金はされません。
429: 1分あたりのリクエスト上限に達しました。Retry-Afterの指定に従って待ってから再試行してください。
503: 処理を完了できませんでした。保留中の請求額は残高に戻されます。結果が不明な場合は、再試行する前に確認してください。
200（空）: データがありません。課金はされません。

エラー

公式リファレンス

対象と用語の確認にのみ使用しています。プラットフォームによるEveryInfraの承認や推奨を意味するものではありません。

Twitch：ログイン名、表示名、配信者タイプ ↗
Twitchの公式ドキュメントでは、login、display_name、broadcaster_typeがそれぞれ個別に定義されています。ここでのusernameにはチャンネルの短い名前を使用し、表示名やPartner/Affiliateのタイプをログイン情報として扱わないでください。公式のユーザー照会でサポートされているその他のパラメータが、自動的にこのAPIに追加されるわけではありません。
確認日：2026-09-04