プラットフォームの稼働状況
- 24時間の稼働状況
- 100%
過去30日間
利用可能な機能
YouTubeの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | キーワードでYouTube動画を1回の呼び出しで最大50件検索します。チャンネル、説明、再生回数、いいね数、コメント数、再生時間、公開日を取得できます。sortで関連度順、新しい順、再生回数順、評価順に並べ替えられます。結果は網羅的ではなく、ランキングの根拠は示されません。 | 1,000リクエストあたり$0.56 | 良好・稼働状況100% |
チャンネル詳細profile | チャンネルURLからYouTubeチャンネルの情報を取得します。自己紹介、登録者数、動画数、再生回数、認証状況、所在地、アバター、バナー、チャンネル開設日を取得できます。YouTubeアナリティクスや登録者の一覧は提供されません。 | 1,000リクエストあたり$0.56 | 正常 |
ユーザーの投稿user_posts | YouTubeチャンネルのURLから動画を1回の呼び出しで最大50件一覧表示します。タイトル、説明、再生回数、いいね数、コメント数、再生時間、公開日を取得できます。開始日はsince、新しい順・古い順・人気順の並べ替えはsortで指定します。1回の取得でチャンネルの全アーカイブを網羅できるとは限りません。 | 1,000リクエストあたり$0.56 | 正常 |
動画の詳細video | 視聴リンクまたは共有リンクから、YouTube動画1本のタイトル、説明、チャンネル、再生回数、いいね数、コメント数、再生時間、公開日を取得します。コメントと文字起こしは、それぞれ専用のアクションcommentsとtranscriptで取得します。 | 1,000リクエストあたり$0.56 | 正常 |
コメントcomments | YouTube動画のコメントを1回の呼び出しで最大100件取得します。各コメントには本文、投稿者、いいね数、返信数、日付、返信かどうかを示すフラグが含まれます。新しい順または人気順で並べ替えができ、sinceで開始日を指定できます。返信の紐付けにはreply_to_idを使います。スレッド全体の取得は保証されません。 | 1,000リクエストあたり$0.56 | 正常 |
フォロワーfollowers | ハンドルからYouTubeチャンネルの登録者数を確認します。フォロー数、投稿数、いいね数、つながり数と、丸められた数値かどうかを示す精度フラグを取得できます。usernameに@ハンドルを渡してください。返されるのは集計値で、登録者の一覧ではありません。 | 1,000リクエストあたり$0.56 | 正常 |
文字起こしtranscript | YouTube動画の字幕を全文テキストとタイムスタンプ付きセグメントで取得し、トラックの言語、利用可能な言語、チャンネル情報も返します。languageでトラックを指定できますが、すべての動画に字幕があるわけではなく、自動翻訳も保証されません。 | 1,000リクエストあたり$0.56 | 正常 |
ショートshorts | ハンドルを指定して、YouTubeチャンネルのショート動画を1回の呼び出しで最大100件取得します。タイトル、サムネイル、再生回数、いいね数、再生時間、公開日を取得できます。usernameにはUCで始まるチャンネルIDではなくハンドルを渡してください。1回の取得でチャンネル内のすべてのショート動画が含まれるとは限りません。 | 1,000リクエストあたり$0.56 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
YouTubeの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索 キーワードでYouTube動画を1回の呼び出しで最大50件検索します。チャンネル、説明、再生回数、いいね数、コメント数、再生時間、公開日を取得できます。 | keyword | sort | Sync配信 | カタログ値：defaultLimit=10、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$0.56 | id · url · title · text · author_name · author_username · author_id · author_url · like_count · comment_count · view_count · duration · posted_at · thumbnail_url · hashtags · is_comments_disabled · is_members_only · is_paid_partnership · author_follower_count · author_video_count · author_view_count · author_created_at · description_links · search_rank · platform |
profileチャンネル詳細 チャンネルURLからYouTubeチャンネルの情報を取得します。自己紹介、登録者数、動画数、再生回数、認証状況、所在地、アバター、バナー、チャンネル開設日を取得できます。YouTubeアナリティクスや登録者の一覧は提供されません。 | url | — | Sync配信 | — | 1,000リクエストあたり$0.56 | channel_id · name · url · bio · subscriber_count · video_count · view_count · is_verified · location · avatar_url · banner_url · created_at · platform |
user_postsユーザーの投稿 YouTubeチャンネルのURLから動画を1回の呼び出しで最大50件一覧表示します。タイトル、説明、再生回数、いいね数、コメント数、再生時間、公開日を取得できます。開始日は | url | since, sort | Sync配信 | カタログ値：defaultLimit=10、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$0.56 | id · url · title · text · author_name · author_username · author_id · author_url · like_count · comment_count · view_count · duration · posted_at · thumbnail_url · hashtags · is_comments_disabled · is_members_only · is_paid_partnership · author_follower_count · author_video_count · author_view_count · author_created_at · description_links · search_rank · platform |
video動画の詳細 視聴リンクまたは共有リンクから、YouTube動画1本のタイトル、説明、チャンネル、再生回数、いいね数、コメント数、再生時間、公開日を取得します。コメントと文字起こしは、それぞれ専用のアクション | url | — | Sync配信 | — | 1,000リクエストあたり$0.56 | id · url · title · text · author_name · author_username · author_id · author_url · like_count · comment_count · view_count · duration · posted_at · thumbnail_url · hashtags · is_comments_disabled · is_members_only · is_paid_partnership · author_follower_count · author_video_count · author_view_count · author_created_at · description_links · search_rank · platform |
commentsコメント YouTube動画のコメントを1回の呼び出しで最大100件取得します。各コメントには本文、投稿者、いいね数、返信数、日付、返信かどうかを示すフラグが含まれます。新しい順または人気順で並べ替えができ、 | url | since, sort | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$0.56 | id · text · author_name · like_count · reply_count · posted_at · is_reply · reply_to_id · platform |
followersフォロワー ハンドルからYouTubeチャンネルの登録者数を確認します。フォロー数、投稿数、いいね数、つながり数と、丸められた数値かどうかを示す精度フラグを取得できます。 | username | channel | Sync配信 | — | 1,000リクエストあたり$0.56 | id · username · url · follower_count · following_count · post_count · like_count · connection_count · precision · platform |
transcript文字起こし YouTube動画の字幕を全文テキストとタイムスタンプ付きセグメントで取得し、トラックの言語、利用可能な言語、チャンネル情報も返します。 | url | language | Sync配信 | — | 1,000リクエストあたり$0.56 | id · url · title · text · segments · language · available_languages · channel_id · channel_name · channel_username · view_count · like_count · comment_count · posted_at · platform |
shortsショート ハンドルを指定して、YouTubeチャンネルのショート動画を1回の呼び出しで最大100件取得します。タイトル、サムネイル、再生回数、いいね数、再生時間、公開日を取得できます。 | username | channel, since, sort | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$0.56 | id · url · title · thumbnail_url · view_count · like_count · duration · posted_at · author_name · author_id · author_url · platform |
YouTubeのsearchのパラメータはそれぞれどういう意味ですか？
キーワードでYouTube動画を1回の呼び出しで最大50件検索します。チャンネル、説明、再生回数、いいね数、コメント数、再生時間、公開日を取得できます。sortで関連度順、新しい順、再生回数順、評価順に並べ替えられます。結果は網羅的ではなく、ランキングの根拠は示されません。
keyword必須- YouTubeのsearchアクションの検索語です。shortsアクションの互換入力として渡した場合は、サイト全体のShorts検索ではなく、チャンネル名として扱われます。
sort任意- YouTubeの各アクションに適用される並び順です。searchではrelevance、newest、most_viewed、top_rated、チャンネルの動画とShortsではnewest、oldest、popular、commentsではnewestとpopularを指定できます。単一の動画を対象とするクエリでこのパラメータを指定しても、その動画のコンテンツは絞り込まれません。指定可能な値:
most_viewednewestrelevancetop_rated
YouTubeのprofileのパラメータはそれぞれどういう意味ですか？
チャンネルURLからYouTubeチャンネルの情報を取得します。自己紹介、登録者数、動画数、再生回数、認証状況、所在地、アバター、バナー、チャンネル開設日を取得できます。YouTubeアナリティクスや登録者の一覧は提供されません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況url必須- YouTubeアクションに必要な対象URLです。profileとuser_postsにはチャンネルの完全なURLを、video、comments、transcriptにはwatch?v=形式のURLや共有リンクを指定してください。チャンネルのメタデータは公開済みのコンテンツから取得されます。また、commentsはチャンネルのコミュニティ投稿を返しません。
YouTubeのuser_postsのパラメータはそれぞれどういう意味ですか？
YouTubeチャンネルのURLから動画を1回の呼び出しで最大50件一覧表示します。タイトル、説明、再生回数、いいね数、コメント数、再生時間、公開日を取得できます。開始日はsince、新しい順・古い順・人気順の並べ替えはsortで指定します。1回の取得でチャンネルの全アーカイブを網羅できるとは限りません。
url必須- YouTubeアクションに必要な対象URLです。profileとuser_postsにはチャンネルの完全なURLを、video、comments、transcriptにはwatch?v=形式のURLや共有リンクを指定してください。チャンネルのメタデータは公開済みのコンテンツから取得されます。また、commentsはチャンネルのコミュニティ投稿を返しません。
since任意- チャンネルの動画、Shorts、コメントを絞り込むための日付の下限です。これらのリストにのみ適用されます。
sort任意- YouTubeの各アクションに適用される並び順です。searchではrelevance、newest、most_viewed、top_rated、チャンネルの動画とShortsではnewest、oldest、popular、commentsではnewestとpopularを指定できます。単一の動画を対象とするクエリでこのパラメータを指定しても、その動画のコンテンツは絞り込まれません。指定可能な値:
newestoldestpopular
YouTubeのvideoのパラメータはそれぞれどういう意味ですか？
視聴リンクまたは共有リンクから、YouTube動画1本のタイトル、説明、チャンネル、再生回数、いいね数、コメント数、再生時間、公開日を取得します。コメントと文字起こしは、それぞれ専用のアクションcommentsとtranscriptで取得します。
url必須- YouTubeアクションに必要な対象URLです。profileとuser_postsにはチャンネルの完全なURLを、video、comments、transcriptにはwatch?v=形式のURLや共有リンクを指定してください。チャンネルのメタデータは公開済みのコンテンツから取得されます。また、commentsはチャンネルのコミュニティ投稿を返しません。
YouTubeのcommentsのパラメータはそれぞれどういう意味ですか？
YouTube動画のコメントを1回の呼び出しで最大100件取得します。各コメントには本文、投稿者、いいね数、返信数、日付、返信かどうかを示すフラグが含まれます。新しい順または人気順で並べ替えができ、sinceで開始日を指定できます。返信の紐付けにはreply_to_idを使います。スレッド全体の取得は保証されません。
url必須- YouTubeアクションに必要な対象URLです。profileとuser_postsにはチャンネルの完全なURLを、video、comments、transcriptにはwatch?v=形式のURLや共有リンクを指定してください。チャンネルのメタデータは公開済みのコンテンツから取得されます。また、commentsはチャンネルのコミュニティ投稿を返しません。
since任意- チャンネルの動画、Shorts、コメントを絞り込むための日付の下限です。これらのリストにのみ適用されます。
sort任意- YouTubeの各アクションに適用される並び順です。searchではrelevance、newest、most_viewed、top_rated、チャンネルの動画とShortsではnewest、oldest、popular、commentsではnewestとpopularを指定できます。単一の動画を対象とするクエリでこのパラメータを指定しても、その動画のコンテンツは絞り込まれません。指定可能な値:
newestpopular
YouTubeのfollowersのパラメータはそれぞれどういう意味ですか？
ハンドルからYouTubeチャンネルの登録者数を確認します。フォロー数、投稿数、いいね数、つながり数と、丸められた数値かどうかを示す精度フラグを取得できます。usernameに@ハンドルを渡してください。返されるのは集計値で、登録者の一覧ではありません。
username必須- followersおよびshortsアクションに必要なチャンネルハンドルです（先頭の@は任意）。followersアクションはユーザー一覧ではなく、登録者数の合計を返します。shortsアクションはハンドルを優先し、UC...形式のチャンネルIDを同じ識別子としては扱いません。
channel任意- チャンネルハンドルを指定するための互換用エイリアスです。/channel/UC...形式の完全なURLは補助ユーティリティで解析に失敗する場合があるため、ハンドルを渡すか、アクションが明示的に提供するURLパラメータを使用してください。
YouTubeのtranscriptのパラメータはそれぞれどういう意味ですか？
YouTube動画の字幕を全文テキストとタイムスタンプ付きセグメントで取得し、トラックの言語、利用可能な言語、チャンネル情報も返します。languageでトラックを指定できますが、すべての動画に字幕があるわけではなく、自動翻訳も保証されません。
url必須- YouTubeアクションに必要な対象URLです。profileとuser_postsにはチャンネルの完全なURLを、video、comments、transcriptにはwatch?v=形式のURLや共有リンクを指定してください。チャンネルのメタデータは公開済みのコンテンツから取得されます。また、commentsはチャンネルのコミュニティ投稿を返しません。
language任意- 文字起こしコンテンツに要求する言語コードです。字幕は利用可能なトラックに基づいて返され、自動翻訳は保証されません。
YouTubeのshortsのパラメータはそれぞれどういう意味ですか？
ハンドルを指定して、YouTubeチャンネルのショート動画を1回の呼び出しで最大100件取得します。タイトル、サムネイル、再生回数、いいね数、再生時間、公開日を取得できます。usernameにはUCで始まるチャンネルIDではなくハンドルを渡してください。1回の取得でチャンネル内のすべてのショート動画が含まれるとは限りません。
username必須- followersおよびshortsアクションに必要なチャンネルハンドルです（先頭の@は任意）。followersアクションはユーザー一覧ではなく、登録者数の合計を返します。shortsアクションはハンドルを優先し、UC...形式のチャンネルIDを同じ識別子としては扱いません。
channel任意- チャンネルハンドルを指定するための互換用エイリアスです。/channel/UC...形式の完全なURLは補助ユーティリティで解析に失敗する場合があるため、ハンドルを渡すか、アクションが明示的に提供するURLパラメータを使用してください。
since任意- チャンネルの動画、Shorts、コメントを絞り込むための日付の下限です。これらのリストにのみ適用されます。
sort任意- YouTubeの各アクションに適用される並び順です。searchではrelevance、newest、most_viewed、top_rated、チャンネルの動画とShortsではnewest、oldest、popular、commentsではnewestとpopularを指定できます。単一の動画を対象とするクエリでこのパラメータを指定しても、その動画のコンテンツは絞り込まれません。指定可能な値:
newestoldestpopular
YouTube 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":"youtube","action":"search","params":{"keyword":"<keyword>"}}'
YouTubeのガイド
これらのアクションを使った実践例と手法です。まずこのページで現在のアクション、パラメータ、フィールドを確認してください。記事内の例や制限は、最新のカタログに代わるものではありません。
YouTubeコメント収集で返信が漏れる理由：2階層のページネーションと完全性の検証
YouTubeのcommentThreadsには、すべての返信が含まれるとは限りません。本ガイドでは公式ドキュメントに基づき、comments.list、parentId、2階層のページネーション、重複排除、コメント数の不一致について解説し、再現可能な取り込み結果の検収方法を紹介します。
記事を読むキャンペーン前のデューデリジェンスでクリエイターデータをどう構造化するか：フォロワー数をオーディエンスの証拠にしない
クリエイターデータプロダクトでは、ブラックボックスの真正性スコアを生成すべきではありません。本記事では、公開指標、許可を得て取得した分析データ、コンテンツとブランドの適合性、開示要件、小規模テスト、キャンペーン後のフィードバックを組み合わせて、検証可能なデューデリジェンスを構成する方法を解説します。
記事を読む統合データAPI入門：機能カタログから最初の有効な結果を得るまで
platform、action、paramsで複数プラットフォームのデータにアクセスします。機能カタログの読み方、最小限のリクエストの送信、非同期タスク・部分的な結果・課金の扱い方、追跡可能なデータ記録の作り方を解説します。
記事を読むYouTube APIに関する質問
YouTube APIでは何を取得できますか？
platformをyoutubeに設定します。現在のカタログには検索、チャンネル詳細、ユーザーの投稿、動画の詳細、コメント、moreが掲載されています。これらのアクション名はそれぞれ異なるYouTubeのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
YouTubeのsearchリクエストを開始するには、どの入力を使用しますか？
YouTubeのsearchアクションの検索語です。shortsアクションの互換入力として渡した場合は、サイト全体のShorts検索ではなく、チャンネル名として扱われます。params内のkeywordとして送信してください。
YouTubeのsearchはどのフィールドを返しますか？
宣言されたスキーマにはtitle、text、author_name、author_usernameが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
YouTubeのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。