Getting started

​
research tiktok

Research TikTok videos, profiles, and comments. Use video URLs and comment IDs from results to retrieve details, replies, or captions.

​
Usage

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

Retrieve profile videos through a Japan proxy

​
Subcommands

​
comments replies list

List TikTok comment replies

terminal
orc research tiktok comments replies list [options]

​
Unique options

​
--url

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

Type: string. Required.

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

Parent comment.id from video/comments.

Type: string. Required.

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

​
profiles get

Get TikTok profile

terminal
orc research tiktok profiles get [options]

​
Unique options

​
--handle

TikTok username without @.

Type: string. Optional.

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

TikTok account ID, alternative to handle.

Type: string. Optional.

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

​
profiles videos list

List TikTok profile videos

terminal
orc research tiktok profiles videos list [options]

​
Unique options

​
--handle

TikTok username without @.

Type: string. Optional.

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

TikTok account ID, alternative to handle.

Type: string. Optional.

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.

Type: string. Optional.

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

​
users search

Search TikTok users

terminal
orc research tiktok users search [options]

​
Unique options

​
--query

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

Type: string. Required.

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

​
videos search

Search TikTok videos

terminal
orc research tiktok videos search [options]

​
Unique options

​
--query

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

Type: string. Required.

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

Type: string. Optional.

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

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

Type: string. Optional.

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.

Type: string. Optional.

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

​
videos get

Get TikTok video

terminal
orc research tiktok videos get [options]

​
Unique options

​
--url

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

Type: string. Required.

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.

Type: string. Optional.

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

​
videos comments list

List TikTok video comments

terminal
orc research tiktok videos comments list [options]

​
Unique options

​
--url

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

Type: string. Required.

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

​
videos transcript get

Get TikTok captions

terminal
orc research tiktok videos transcript get [options]

​
Unique options

​
--url

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

Type: string. Required.

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

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

Type: string. Optional.

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

​
Output and continuation

Each call returns one page. When continuation is available, pass the top-level pagination.next_cursor as --cursor with unchanged filters. Never replay data.next_cursor. has_more: null means unknown, not complete. --page-all is unavailable.

JSON retains records in data.data, continuation in data.pagination and provenance in data.source. --raw removes the CLI envelope; --field data selects the API data. Missing and null values do not mean zero.

data.usage.provider_credits uses the provider’s units, not Orchestor billing units. See each API reference for coverage and provider-specific constraints.

​
Permissions

Sign in with orc auth login using a beta-approved account, or use an API key with the read scope. Select an accessible workspace with --workspace. No research-specific workspace allowlist is required.

​
Global Options

The following global options can be used with orc research tiktok:

For details and examples, see global options.