​

research youtube

orc research youtube は、YouTubeのチャンネル・動画を検索し、公開情報や字幕を取得するコマンドです。動画の公開日時・長さ・地域などで検索を絞り込み、複数の動画IDから字幕をまとめて取得できます。

認証済みのCLIと、アクセス可能なWorkspaceが必要です。--workspace で今回の対象を指定できます。

公開動画を検索する。

UC で始まるチャンネルIDまたは @ を除いたhandleでチャンネルを取得します。表示名は使いません。

YouTube channel ID, starting with UC; not a display name.

型: string。任意。

Channel handle without @.; max 100 chars

型: string。任意。

チャンネルの公開Videosタブを取得します。--sort で新しい順または人気順を選び、--include-extras true で追加の公開日時や反応を取得できます。

YouTube channel ID, starting with UC; not a display name.

型: string。任意。

Channel handle without @.; max 100 chars

型: string。任意。

Order the public Videos tab by recency or popularity. Omission sends no sort override.; enum: latest|popular

型: string。任意。

Request enriched publication dates, descriptions and engagement with true. Send the literal query string true or false. Omission sends no extras override.; enum: true|false

型: string。任意。

--query の語句でチャンネルを検索します。続きは返されたカーソルで取得します。

Search text.; max 500 chars

型: string。必須。

動画を検索し、チャンネル、公開日時、長さ、言語、地域、並び順で絞り込めます。--include-extras true は長さと反応の追加取得で、1ページに5 provider creditsが加算されます。

Search text.; max 500 chars

型: string。必須。

YouTube channel ID, starting with UC; not a display name.

型: string。任意。

Lower publication-time bound in ISO 8601 with a timezone. Must precede published_before when both are supplied. Omission adds no date cutoff.

型: string。任意。

Upper publication-time bound in ISO 8601 with a timezone. Must follow published_after when both are supplied. Omission adds no upper date bound.

型: string。任意。

Requested provider sort key. When omitted, Orchestor sends no order override.; enum: date|relevance|viewCount|rating|title

型: string。任意。

Requested page size from 1 to 50. The provider may return fewer rows. Omission sends no page-size override.

型: number。任意。

Provider video-duration category. any requests no duration restriction; omission sends no override. Category boundaries are determined by the provider.; enum: short|medium|long|any

型: string。任意。

Two-letter preferred language. Caption behavior differs between single and batch endpoints.

型: string。任意。

Two-uppercase-letter region code forwarded to the provider, for example JP or US. Omission sends no regional override.

型: string。任意。

Adds duration and engagement at an additional provider cost of 5 credits per page.; enum: true|false

型: string。任意。

1〜20件の重複しない動画IDを --ids へ渡し、字幕を一括取得します。字幕の形式は --export-format、CLI出力の形式は --format で指定します。

Requested caption representation. Defaults to timed segments with millisecond timing; text requests combined caption text.; enum: text|segments

型: string。任意。

(required) One to twenty distinct video IDs. Correlate results using each row index and target.; csv

型: string。任意。

Two-letter preferred language. Caption behavior differs between single and batch endpoints.

型: string。任意。

watch・Shorts・live・youtu.beの公開動画URLを指定して動画情報を取得します。

YouTube watch, Shorts, live or youtu.be URL.; max 2048 chars

型: string。必須。

Two-letter preferred language. Caption behavior differs between single and batch endpoints.

型: string。任意。

公開動画URLから字幕を取得します。音声からのAI文字起こしや翻訳は行いません。

YouTube watch, Shorts, live or youtu.be URL.; max 2048 chars

型: string。必須。

Two-letter preferred language. Caption behavior differs between single and batch endpoints.

型: string。任意。

2つの動画の字幕をテキストで取得する。

継続できる一覧ではAPIのトップレベル pagination.next_cursor を --cursor に渡し、条件を維持します。CLIのJSON出力からは data.pagination.next_cursor を取り出してください。取得内容の内部にある data.next_cursor は継続に使いません。has_more: null は不明を意味し、完了ではありません。--page-all は使えません。

--json ではAPIレスポンス全体をCLIの data に保持します。取得内容は data.data、継続情報は data.pagination、取得元情報は data.source です。--raw はCLIの外枠を外し、--field data はAPIのデータだけを選択します。欠損値やnullを0として扱わないでください。

data.usage.provider_credits は取得元の単位で、Orchestorの請求単位とは異なります。

transcripts get はPOSTですがreadスコープです。--ids は1〜20件の重複しない動画IDをカンマ区切りで指定します。--export-format text は字幕の形式、--format json はCLI出力形式です。segmentsの時刻はミリ秒です。公開字幕・自動字幕を取得し、音声からのAI文字起こしや翻訳は行いません。HTTP 200でも部分成功があるため、各行の status と summary を確認し、成功済みの行を再送しないでください。

APIキーではreadスコープが必要です。 プロバイダーのキーはサーバー側で管理します。

orc research youtube では、次のグローバルオプションを使用できます。

各オプションの詳細と使用例は、グローバルオプションを参照してください。