メインコンテンツへスキップ
公開されている YouTube のデータを非同期タスク API で JSON として読み取ります。taskType SOCIAL に platform youtube を指定し、action で読み取る対象を選びます。完了したリクエスト 1 件につき 0.5 クレジットです。

リクエスト

タスクを送信したあと、GET /v1/async/task/{id} をポーリングするか Webhook で受け取ります。非同期タスクを参照してください。

アクション

videoId には動画 ID か YouTube 動画の URL (視聴ページ、youtu.be、ショート、埋め込み) を指定します。channel にはチャンネル ID (UC...)、@handle、チャンネル URL を指定します。

パラメータ

search と recent:
  • query: 必須。検索語句です。
  • limit: 任意の整数、1-50。デフォルトは 10 です。
  • type: video (デフォルト)、all、shorts、channel、playlist、movie のいずれかです。
  • order: relevance (デフォルト)、viewCount、date、rating のいずれかです。date は recent と同じく新しいアップロードから並べます。rating は YouTube の再生回数上位の結果を高評価数で並べ替えます。channel と playlist の検索は relevance か viewCount を受け付けます。
  • publishedAfter: 2026-11-01T00:00:00Z のような ISO 8601 の日時です。この日時より後に公開された動画を返します。
  • videoDuration: short (3 分未満)、medium (3-20 分)、long (20 分超) のいずれかです。
  • features: live、4k、hd、subtitles、creative_commons、360、vr180、3d、hdr、location、purchased から任意の値を、配列かカンマ区切りの文字列で指定します。
  • exactSpelling: true にすると、YouTube のスペル補正なしで入力どおりに検索します。
  • pageToken: 前のページの nextPageToken です。publishedAfter なしで relevance か viewCount で並べた動画検索がこの値を返し、各ページはそれまでのページが返した動画をすべて飛ばします。
  • regionCode と languageCode: 検索する YouTube の地域 (US、KR、JP) と表示言語 (en、ko、ja) です。
comments:
  • limit: 任意の整数、1-500。デフォルトは 100 です。返信も件数に含まれます。
  • order: relevance (デフォルト、YouTube の評価順) か time (新しい順) です。
  • includeReplies: 任意。デフォルトは true です。
channel_videos:
  • tab: videos (デフォルト)、shorts、streams のいずれかです。
  • sort: latest (デフォルト)、popular、oldest のいずれかです。
  • limit: 任意の整数、1-50。デフォルトは 20 です。
transcript:
  • languages: ["en", "ko"] のように優先順に並べた字幕の言語です。指定しない場合は、動画のデフォルト字幕、英語、最初のトラックの順に読み取ります。
  • isGenerated: true は自動生成字幕だけを、false はアップロード者の字幕だけを読み取ります。
  • trackName: 読み取る字幕トラックの名前です。
  • translateTo: 言語コードです。YouTube が字幕をその言語に翻訳します。
  • maxSegments: 任意の整数、1-5,000。デフォルトは 2,000 です。

レスポンス例

結果フィールド

  • すべてのレスポンスは platform と action をそのまま返します。一覧には returnedCount があります。
  • search と recent は videos を返します。各動画には position、videoId、url、title、description、チャンネルの channelId、channelTitle、channelHandle、channelUrl、channelThumbnail、channelIsVerified、publishedAt、publishedTimeText、duration (ISO 8601)、durationSeconds、viewCount、likeCount、category、thumbnails、richThumbnail (動くプレビュー)、badges、isFamilySafe があります。映画にはポスター、ジャンル、公開年、出演者、監督を含む movie が加わります。
  • 検索は、結果ページに表示される channels、playlists、shorts、shelves と totalResults (YouTube の推定値) も返し、YouTube が検索語句を補正したときは didYouMean か showingResultsFor を返します。
  • video は tags、commentCount、subscriberCount、hasCaptions、chapters、mostReplayed、music、descriptionLinks、relatedVideos を加えます。アップロード者のチャプターが先に来て、自動チャプターには autoGenerated: true が付きます。
  • comments は comments を返します。各コメントには commentId、parentId (トップレベルのコメントでは null)、text、authorDisplayName、authorChannelId、authorProfileImageUrl、authorIsVerified、authorIsChannelOwner、isPinned、isHearted、likeCount、replyCount、publishedAt、updatedAt があります。totalCount は YouTube が表示する件数で、topLevelCount と replyCount は returnedCount の内訳です。
  • channel は channelId、title、handle、description、country、publishedAt、subscriberCount、videoCount、viewCount、isVerified、keywords、links、thumbnails、bannerUrl、rssUrl、uploadsPlaylistId を返します。
  • channel_videos は sort の順に並んだ videos と、チャンネルの channelId、channelTitle を返します。
  • transcript は字幕の text、時刻付きの segments (start と duration、秒単位)、読み取った language、availableLanguages を返します。truncated: true は maxSegments で切り詰めた字幕を示します。
  • 高評価数を非表示にした動画には likesHidden: true、コメントをオフにした動画には commentsDisabled: true が付きます。メンバー限定動画には membersOnly: true が付き、viewCount はありません。
  • 存在しない動画、チャンネル、字幕トラックや、年齢制限付き動画のようにログインした視聴者にしか表示されないものは、タスクを PAGE_UNAVAILABLE で終了させます。組み合わせられないパラメータはタスクを BAD_PAYLOAD で終了させます。課金されるのは完了したリクエストだけです。

関連