CLI を使い始める

research tiktok

TikTok の動画、プロフィール、コメントを調査します。検索結果の動画 URL やコメント ID を使って詳細、返信、字幕へ進めます。

使い方

terminal
orc research tiktok profiles videos list --handle example --region JP --workspace YOUR_WORKSPACE_ID --format json

日本向けプロキシからプロフィールの動画を取得する

サブコマンド

comments replies list

コメントの返信を一覧取得します。

terminal
orc research tiktok comments replies list [options]

固有のオプション

--url

Canonical HTTPS TikTok video or photo URL. Resolve share shortlinks before calling. Media URLs in responses may expire.; max 2048 chars

型: string。必須。

terminal
orc research tiktok comments replies list --url <value>
--comment-id

Parent comment.id from video/comments.

型: string。必須。

terminal
orc research tiktok comments replies list --comment-id <value>

profiles get

プロフィールを取得します。

terminal
orc research tiktok profiles get [options]

固有のオプション

--handle

TikTok username without @.

型: string。任意。

terminal
orc research tiktok profiles get --handle <value>
--user-id

TikTok account ID, alternative to handle.

型: string。任意。

terminal
orc research tiktok profiles get --user-id <value>

profiles videos list

プロフィールの動画を一覧取得します。

terminal
orc research tiktok profiles videos list [options]

固有のオプション

--handle

TikTok username without @.

型: string。任意。

terminal
orc research tiktok profiles videos list --handle <value>
--user-id

TikTok account ID, alternative to handle.

型: string。任意。

terminal
orc research tiktok profiles videos list --user-id <value>
--region

Proxy country, for example JP. This does not filter video origin. Inspect post.ext.region; video detail honors region only on a supporting fallback source.

型: string。任意。

terminal
orc research tiktok profiles videos list --region <value>

ユーザーを検索します。

terminal
orc research tiktok users search [options]

固有のオプション

--query

Search text. Search indexes do not guarantee exhaustive coverage.; max 500 chars

型: string。必須。

terminal
orc research tiktok users search --query <value>

動画を検索します。

terminal
orc research tiktok videos search [options]

固有のオプション

--query

Search text. Search indexes do not guarantee exhaustive coverage.; max 500 chars

型: string。必須。

terminal
orc research tiktok videos search --query <value>
--date-posted

Relative publication window interpreted by TikTok.; enum: yesterday|this-week|this-month|last-3-months|last-6-months|all-time

型: string。任意。

terminal
orc research tiktok videos search --date-posted <value>
--sort-by

Source search ordering.; enum: relevance|most-liked|date-posted

型: string。任意。

terminal
orc research tiktok videos search --sort-by <value>
--region

Proxy country, for example JP. This does not filter video origin. Inspect post.ext.region; video detail honors region only on a supporting fallback source.

型: string。任意。

terminal
orc research tiktok videos search --region <value>

videos get

動画を取得します。

terminal
orc research tiktok videos get [options]

固有のオプション

--url

Canonical HTTPS TikTok video or photo URL. Resolve share shortlinks before calling. Media URLs in responses may expire.; max 2048 chars

型: string。必須。

terminal
orc research tiktok videos get --url <value>
--region

Proxy country, for example JP. This does not filter video origin. Inspect post.ext.region; video detail honors region only on a supporting fallback source.

型: string。任意。

terminal
orc research tiktok videos get --region <value>

videos comments list

動画のコメントを一覧取得します。

terminal
orc research tiktok videos comments list [options]

固有のオプション

--url

Canonical HTTPS TikTok video or photo URL. Resolve share shortlinks before calling. Media URLs in responses may expire.; max 2048 chars

型: string。必須。

terminal
orc research tiktok videos comments list --url <value>

videos transcript get

動画の字幕を取得します。

terminal
orc research tiktok videos transcript get [options]

固有のオプション

--url

Canonical HTTPS TikTok video or photo URL. Resolve share shortlinks before calling. Media URLs in responses may expire.; max 2048 chars

型: string。必須。

terminal
orc research tiktok videos transcript get --url <value>
--language

Preferred two-letter caption language; does not translate the source.

型: string。任意。

terminal
orc research tiktok videos transcript get --language <value>

出力と継続

1回で1ページを取得します。継続可能な場合はトップレベルの pagination.next_cursor を --cursor に渡し、検索条件を維持します。data.next_cursor は使用しません。has_more: null は不明であり、完了ではありません。--page-all は使えません。

JSONでは data.data に取得内容、data.pagination に継続情報、data.source に取得元情報が入ります。--raw はCLIの外枠を外し、--field data はAPIのデータだけを選択します。欠損・nullを0として扱わないでください。

data.usage.provider_credits は取得元の単位で、Orchestorの請求単位とは異なります。取得範囲・プロバイダー固有の制約は各APIリファレンスに記載しています。

必要な権限

orc auth login でベータ承認済みアカウントにログインするか、read スコープの API キーを使用します。アクセスできる Workspace を --workspace で指定します。research 専用の Workspace 許可リストは不要です。

グローバルオプション

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

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