--- title: research tiktok description: Research TikTok videos, profiles, and comments. canonical_url: https://orchestor.io/docs/en/cli/research/tiktok markdown_url: https://orchestor.io/docs/en/cli/research/tiktok.md contentType: reference --- # research tiktok Research TikTok videos, profiles, and comments. Use video URLs and comment IDs from results to retrieve details, replies, or captions. ## Usage ```bash title="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 ```bash title="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. ```bash title="terminal" orc research tiktok comments replies list --url ``` ##### `--comment-id` Parent comment.id from video/comments. Type: `string`. Required. ```bash title="terminal" orc research tiktok comments replies list --comment-id ``` ### `profiles get` Get TikTok profile ```bash title="terminal" orc research tiktok profiles get [options] ``` #### Unique options ##### `--handle` TikTok username without @. Type: `string`. Optional. ```bash title="terminal" orc research tiktok profiles get --handle ``` ##### `--user-id` TikTok account ID, alternative to handle. Type: `string`. Optional. ```bash title="terminal" orc research tiktok profiles get --user-id ``` ### `profiles videos list` List TikTok profile videos ```bash title="terminal" orc research tiktok profiles videos list [options] ``` #### Unique options ##### `--handle` TikTok username without @. Type: `string`. Optional. ```bash title="terminal" orc research tiktok profiles videos list --handle ``` ##### `--user-id` TikTok account ID, alternative to handle. Type: `string`. Optional. ```bash title="terminal" orc research tiktok profiles videos list --user-id ``` ##### `--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. ```bash title="terminal" orc research tiktok profiles videos list --region ``` ### `users search` Search TikTok users ```bash title="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. ```bash title="terminal" orc research tiktok users search --query ``` ### `videos search` Search TikTok videos ```bash title="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. ```bash title="terminal" orc research tiktok videos search --query ``` ##### `--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. ```bash title="terminal" orc research tiktok videos search --date-posted ``` ##### `--sort-by` Source search ordering.; enum: relevance|most-liked|date-posted Type: `string`. Optional. ```bash title="terminal" orc research tiktok videos search --sort-by ``` ##### `--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. ```bash title="terminal" orc research tiktok videos search --region ``` ### `videos get` Get TikTok video ```bash title="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. ```bash title="terminal" orc research tiktok videos get --url ``` ##### `--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. ```bash title="terminal" orc research tiktok videos get --region ``` ### `videos comments list` List TikTok video comments ```bash title="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. ```bash title="terminal" orc research tiktok videos comments list --url ``` ### `videos transcript get` Get TikTok captions ```bash title="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. ```bash title="terminal" orc research tiktok videos transcript get --url ``` ##### `--language` Preferred two-letter caption language; does not translate the source. Type: `string`. Optional. ```bash title="terminal" orc research tiktok videos transcript get --language ``` ## 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](https://orchestor.io/docs/cli/global-flags.md) can be used with `orc research tiktok`: - [`--help`](https://orchestor.io/docs/cli/global-flags.md#help) - [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#workspace) - [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-output) - [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-output) - [`--format`](https://orchestor.io/docs/cli/global-flags.md#output-format) - [`--field`](https://orchestor.io/docs/cli/global-flags.md#field-selection) - [`--fields`](https://orchestor.io/docs/cli/global-flags.md#field-selection) - [`--raw`](https://orchestor.io/docs/cli/global-flags.md#raw-output) - [`--output`](https://orchestor.io/docs/cli/global-flags.md#file-output) - [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#pager) - [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#dry-run) - [`--yes`](https://orchestor.io/docs/cli/global-flags.md#confirmation) - [`--cursor`](https://orchestor.io/docs/cli/global-flags.md) - [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input) - [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#standard-input) - [`--timing`](https://orchestor.io/docs/cli/global-flags.md#request-timing) For details and examples, see [global options](https://orchestor.io/docs/cli/global-flags.md). --- [Documentation index](https://orchestor.io/docs/llms.txt)