プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
Twitchの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | キーワードでTwitchチャンネルを検索します。フォロワー数、PartnerまたはAffiliateのステータス、ライブ状態、前回の配信の詳細が含まれます。検索対象はチャンネルであり、チャットは含みません。is_liveは呼び出し時点の状態を示すもので、保証するものではありません。 | 1,000リクエストあたり$1.39 | 正常 |
プロフィールprofile | Twitchチャンネルのプロフィール、PartnerまたはAffiliateのステータス、ライブ配信の詳細、前回の配信を取得します。最近の動画と人気クリップはデフォルトで含まれます。これらのセクションを除外するには、include_videosまたはinclude_clipsにブール値のfalseを設定します。収益、サブスクライバー名、非公開の分析データは公開されません。 | 1,000リクエストあたり$1.39 | 正常 |
クリップclips | Twitchチャンネルから切り抜かれたクリップを取得します。各クリップにはタイトル、視聴回数、長さ、ゲーム、クリップを作成した視聴者が含まれます。periodで過去1日、1週間（デフォルト）、1か月、全期間から選択します。期間内のすべてのクリップが含まれるとは限りません。 | 1,000リクエストあたり$1.39 | 正常 |
配信streams | カテゴリ内で現在ライブ配信中のTwitchチャンネルを、配信タイトル、視聴者数、フォロワー数、開始時刻とともに一覧で取得します。gameにはJust Chattingのような正確なカテゴリ名が必要です。視聴者数は取得時点のスナップショットです。 | 1,000リクエストあたり$1.39 | 正常 |
人気配信top_streams | Twitchの人気ライブ配信を、チャンネル、タイトル、ゲーム、視聴者数、開始時刻とともに確認できます。入力は不要です。この並び順は継続的なランキングではなく、当社独自のおすすめでもありません。 | 1,000リクエストあたり$1.39 | 正常 |
人気ゲームtop_games | Twitchの人気ゲームを、視聴者数、配信者数、ボックスアートとともに追跡します。入力は不要です。これらの数値はTwitchでの視聴状況のみを表すもので、売上、総プレイヤー数、他のプラットフォームでの人気を示すものではありません。 | 1,000リクエストあたり$1.39 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Twitchの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索 キーワードでTwitchチャンネルを検索します。フォロワー数、PartnerまたはAffiliateのステータス、ライブ状態、前回の配信の詳細が含まれます。検索対象はチャンネルであり、チャットは含みません。 | keyword | — | Sync配信 | カタログ値：defaultLimit=10、maxLimit=30。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | user_id · username · display_name · bio · url · avatar_url · banner_url · follower_count · 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 · platform |
profileプロフィール Twitchチャンネルのプロフィール、PartnerまたはAffiliateのステータス、ライブ配信の詳細、前回の配信を取得します。最近の動画と人気クリップはデフォルトで含まれます。これらのセクションを除外するには、 | username | include_clips, include_videos | Sync配信 | — | 1,000リクエストあたり$1.39 | user_id · username · display_name · bio · url · avatar_url · banner_url · follower_count · 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 · recent_videos · top_clips · platform |
clipsクリップ Twitchチャンネルから切り抜かれたクリップを取得します。各クリップにはタイトル、視聴回数、長さ、ゲーム、クリップを作成した視聴者が含まれます。 | username | period | Sync配信 | カタログ値：defaultLimit=10、maxLimit=30。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · title · url · view_count · duration_seconds · duration_sec · game · channel_username · channel_name · curator_username · curator_name · thumbnail_url · created_at · platform |
streams配信 カテゴリ内で現在ライブ配信中のTwitchチャンネルを、配信タイトル、視聴者数、フォロワー数、開始時刻とともに一覧で取得します。 | game | — | Sync配信 | カタログ値：defaultLimit=10、maxLimit=30。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | stream_id · username · display_name · follower_count · title · viewer_count · game · started_at · url · avatar_url · platform |
top_streams人気配信 Twitchの人気ライブ配信を、チャンネル、タイトル、ゲーム、視聴者数、開始時刻とともに確認できます。入力は不要です。この並び順は継続的なランキングではなく、当社独自のおすすめでもありません。 | — | Sync配信 | カタログ値：defaultLimit=10、maxLimit=30。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | stream_id · username · display_name · follower_count · title · viewer_count · game · started_at · url · avatar_url · platform | |
top_games人気ゲーム Twitchの人気ゲームを、視聴者数、配信者数、ボックスアートとともに追跡します。入力は不要です。これらの数値はTwitchでの視聴状況のみを表すもので、売上、総プレイヤー数、他のプラットフォームでの人気を示すものではありません。 | — | Sync配信 | カタログ値：defaultLimit=10、maxLimit=200。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · name · viewer_count · broadcaster_count · box_art_url · url · platform |
Twitchのsearchのパラメータはそれぞれどういう意味ですか？
キーワードでTwitchチャンネルを検索します。フォロワー数、PartnerまたはAffiliateのステータス、ライブ状態、前回の配信の詳細が含まれます。検索対象はチャンネルであり、チャットは含みません。is_liveは呼び出し時点の状態を示すもので、保証するものではありません。
keyword必須- searchで使用するチャンネルのキーワードです。streamsエンドポイントでは、任意の配信タイトルのキーワードではなく、gameで正確なゲーム名またはカテゴリー名を指定する必要があります。
Twitchのprofileのパラメータはそれぞれどういう意味ですか？
Twitchチャンネルのプロフィール、PartnerまたはAffiliateのステータス、ライブ配信の詳細、前回の配信を取得します。最近の動画と人気クリップはデフォルトで含まれます。これらのセクションを除外するには、include_videosまたはinclude_clipsにブール値のfalseを設定します。収益、サブスクライバー名、非公開の分析データは公開されません。
username必須- profileまたはclipsで使用するTwitchチャンネルのログイン名（ショートネーム）です。先頭に@を付けることもできます。twitch.tvの完全なURLは解析されません。Twitch：ログイン名、表示名、配信者タイプ — Twitchの公式ドキュメントでは、login、display_name、broadcaster_typeがそれぞれ個別に定義されています。ここでのusernameにはチャンネルの短い名前を使用し、表示名やPartner/Affiliateのタイプをログイン情報として扱わないでください。公式のユーザー照会でサポートされているその他のパラメータが、自動的にこのAPIに追加されるわけではありません。 · 確認日
include_clips任意- profileのレスポンスに厳選されたクリップ情報を含めるかどうかを示すブール値で、デフォルトはtrueです。対象期間は単体のclipsエンドポイントとは異なります。
include_videos任意- profileのレスポンスに最近の動画アーカイブ情報を含めるかどうかを示すブール値で、デフォルトはtrueです。このセクションを省くにはfalseを指定してください。文字列"false"は指定しないでください。
Twitchのclipsのパラメータはそれぞれどういう意味ですか？
Twitchチャンネルから切り抜かれたクリップを取得します。各クリップにはタイトル、視聴回数、長さ、ゲーム、クリップを作成した視聴者が含まれます。periodで過去1日、1週間（デフォルト）、1か月、全期間から選択します。期間内のすべてのクリップが含まれるとは限りません。
username必須- profileまたはclipsで使用するTwitchチャンネルのログイン名（ショートネーム）です。先頭に@を付けることもできます。twitch.tvの完全なURLは解析されません。
period任意- clipsの対象期間です。過去1日はLAST_DAY、過去1週間はLAST_WEEK（デフォルト）、過去1か月はLAST_MONTH、制限なしはALL_TIMEを指定します。値の大文字と小文字は区別されず、無効な値はLAST_WEEKとして扱われます。Twitch：クリップの作成者、配信元チャンネル、視聴回数 — Twitchのクリップに関する公式ドキュメントでは、broadcasterとcreatorを区別し、view_countをクリップの視聴回数、durationを秒単位の長さとして定義しています。このセクションは用語の確認のみを目的としており、公式の開始日・終了日、カーソル、クリップ作成のパラメータを再現するものではありません。 · 確認日
Twitchのstreamsのパラメータはそれぞれどういう意味ですか？
カテゴリ内で現在ライブ配信中のTwitchチャンネルを、配信タイトル、視聴者数、フォロワー数、開始時刻とともに一覧で取得します。gameにはJust Chattingのような正確なカテゴリ名が必要です。視聴者数は取得時点のスナップショットです。
game必須- streamsで使用するTwitchの正確なカテゴリー名（Just Chattingなど）です。そのゲームの過去の動画アーカイブではなく、そのカテゴリーで現在配信中のチャンネルを返します。Twitch：ライブ配信のカテゴリと現在の視聴者数 — 公式のライブ配信ドキュメントでは、カテゴリ、チャンネル、現在のライブ配信を区別し、viewer_countを現在その配信を視聴しているユーザー数と定義しています。これはクリップの視聴回数、フォロワー数、過去の累計視聴回数ではありません。また、公式のgame_idパラメータは、このページで必須のカテゴリ名の代わりにはなりません。 · 確認日
Twitchのtop_streamsのパラメータはそれぞれどういう意味ですか？
Twitchの人気ライブ配信を、チャンネル、タイトル、ゲーム、視聴者数、開始時刻とともに確認できます。入力は不要です。この並び順は継続的なランキングではなく、当社独自のおすすめでもありません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況このアクションには固有のパラメータがありません。プラットフォームとアクションの識別子のみを送信してください。
Twitchのtop_gamesのパラメータはそれぞれどういう意味ですか？
Twitchの人気ゲームを、視聴者数、配信者数、ボックスアートとともに追跡します。入力は不要です。これらの数値はTwitchでの視聴状況のみを表すもので、売上、総プレイヤー数、他のプラットフォームでの人気を示すものではありません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況このアクションには固有のパラメータがありません。プラットフォームとアクションの識別子のみを送信してください。
Twitch APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"twitch","action":"search","params":{"keyword":"<keyword>"}}'
Twitch APIに関する質問
Twitch APIでは何を取得できますか？
platformをtwitchに設定します。現在のカタログには検索、プロフィール、クリップ、配信、人気配信、moreが掲載されています。これらのアクション名はそれぞれ異なるTwitchのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Twitchのsearchリクエストを開始するには、どの入力を使用しますか？
searchで使用するチャンネルのキーワードです。streamsエンドポイントでは、任意の配信タイトルのキーワードではなく、gameで正確なゲーム名またはカテゴリー名を指定する必要があります。params内のkeywordとして送信してください。
Twitchのsearchはどのフィールドを返しますか？
宣言されたスキーマにはuser_id、username、display_name、bioが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Twitchのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。