> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adside.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# TikTok

> The 14 adside commands for TikTok.

See [Using commands](https://docs.adside.ai/cli/commands.md) for how flags, JSON input, paging and confirmations work. Run `adside tiktok --help` to see what your installed version has.

## tiktok action-categories

### tiktok action-categories get

List TikTok behavior/action categories for targeting (user actions on TikTok).

Beta: this command may still change.

```bash theme={null}
adside tiktok action-categories get [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--advertiser-id` | `<id>` | Omit it: it defaults to the advertiser this workspace is connected to, and any other advertiser is refused. |
| `--language` | `<language>=en` | Language code |

## tiktok ad-groups

### tiktok ad-groups list

List TikTok ad groups with optional filtering.

Beta: this command may still change.

```bash theme={null}
adside tiktok ad-groups list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--advertiser-id` | `<id>` | Omit it: it defaults to the advertiser this workspace is connected to, and any other advertiser is refused. |
| `--adgroup-ids` | `'<json>'` | Filter by ad group IDs |
| `--campaign-ids` | `'<json>'` | Filter by parent campaign IDs |
| `--filtering` | `'<json>'` | |
| `--page` | `<min 1>=1` | The next page, from the previous output. |
| `--page-size` | `<1-1000>=100` | |

## tiktok ads

### tiktok ads list

List TikTok ads with optional filtering by ad group, campaign, or status.

Beta: this command may still change.

```bash theme={null}
adside tiktok ads list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--advertiser-id` | `<id>` | Omit it: it defaults to the advertiser this workspace is connected to, and any other advertiser is refused. |
| `--ad-ids` | `'<json>'` | Filter by ad IDs |
| `--adgroup-ids` | `'<json>'` | Filter by ad group IDs |
| `--campaign-ids` | `'<json>'` | Filter by campaign IDs |
| `--filtering` | `'<json>'` | |
| `--page` | `<min 1>=1` | The next page, from the previous output. |
| `--page-size` | `<1-1000>=100` | |

## tiktok advertiser-info

### tiktok advertiser-info get

Get TikTok advertiser account details (name, status, currency, timezone, balance).

Beta: this command may still change.

```bash theme={null}
adside tiktok advertiser-info get [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--advertiser-id` | `<id>` | Omit it: it defaults to the advertiser this workspace is connected to, and any other advertiser is refused. |

## tiktok advertisers

### tiktok advertisers list

List the TikTok advertiser account this workspace is connected to.

Beta: this command may still change.

```bash theme={null}
adside tiktok advertisers list
```

## tiktok audience-report

### tiktok audience-report get

Get TikTok audience demographic breakdown (age, gender, country, OS, language).

Beta: this command may still change.

```bash theme={null}
adside tiktok audience-report get --start-date <start-date> --end-date <end-date> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--start-date` (required) | `<start-date>` | Start date (YYYY-MM-DD) |
| `--end-date` (required) | `<end-date>` | End date (YYYY-MM-DD) |
| `--advertiser-id` | `<id>` | Omit it: it defaults to the advertiser this workspace is connected to, and any other advertiser is refused. |
| `--data-level` | `AUCTION_CAMPAIGN\|AUCTION_ADGROUP\|AUCTION_AD=AUCTION_CAMPAIGN` | |
| `--dimensions` | `'<json>'` | Audience dimensions: gender, age, country\_code, ac (Android/iOS), language |
| `--metrics` | `'<json>'` | Metrics to include |
| `--filters` | `'<json>'` | |
| `--page` | `<min 1>=1` | The next page, from the previous output. |
| `--page-size` | `<1-1000>=100` | |

## tiktok campaigns

### tiktok campaigns list

List TikTok ad campaigns with optional filtering by name, objective, status.

Beta: this command may still change.

```bash theme={null}
adside tiktok campaigns list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--advertiser-id` | `<id>` | Omit it: it defaults to the advertiser this workspace is connected to, and any other advertiser is refused. |
| `--campaign-ids` | `'<json>'` | Filter by specific campaign IDs |
| `--filtering` | `'<json>'` | |
| `--page` | `<min 1>=1` | The next page, from the previous output. |
| `--page-size` | `<1-1000>=100` | |

## tiktok identities

### tiktok identities get

List available TikTok identities for ad creation.

Beta: this command may still change.

```bash theme={null}
adside tiktok identities get [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--advertiser-id` | `<id>` | Omit it: it defaults to the advertiser this workspace is connected to, and any other advertiser is refused. |
| `--identity-type` | `CUSTOMIZED_USER\|AUTH_CODE\|TT_USER\|BC_AUTH_TT` | Filter by identity type |

## tiktok image-info

### tiktok image-info get

Get TikTok image details (dimensions, format, URL).

Beta: this command may still change.

```bash theme={null}
adside tiktok image-info get --image-ids '<json>' [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--image-ids` (required) | `'<json>'` | Image IDs to get info for |
| `--advertiser-id` | `<id>` | Omit it: it defaults to the advertiser this workspace is connected to, and any other advertiser is refused. |

## tiktok interest-categories

### tiktok interest-categories get

List all TikTok interest category tree for browsing (not keyword search).

Beta: this command may still change.

```bash theme={null}
adside tiktok interest-categories get [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--advertiser-id` | `<id>` | Omit it: it defaults to the advertiser this workspace is connected to, and any other advertiser is refused. |
| `--language` | `<language>=en` | Language code for category names |

### tiktok interest-categories search

Search TikTok interest categories by keyword for targeting.

Beta: this command may still change.

```bash theme={null}
adside tiktok interest-categories search --keyword <keyword> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--keyword` (required) | `<keyword>` | Search keyword for interest targeting |
| `--advertiser-id` | `<id>` | Omit it: it defaults to the advertiser this workspace is connected to, and any other advertiser is refused. |
| `--language` | `<language>=en` | Language code for results |

## tiktok locations

### tiktok locations search

Search TikTok targeting locations by keyword.

Beta: this command may still change.

```bash theme={null}
adside tiktok locations search --keyword <keyword> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--keyword` (required) | `<keyword>` | Location name to search |
| `--advertiser-id` | `<id>` | Omit it: it defaults to the advertiser this workspace is connected to, and any other advertiser is refused. |
| `--level` | `COUNTRY\|PROVINCE\|CITY\|DMA` | Location level to search |
| `--language` | `<language>=en` | |

## tiktok report

### tiktok report get

Get TikTok integrated reporting with dimensions, metrics, date range, and filters.

Beta: this command may still change.

```bash theme={null}
adside tiktok report get --start-date <start-date> --end-date <end-date> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--start-date` (required) | `<start-date>` | Start date (YYYY-MM-DD) |
| `--end-date` (required) | `<end-date>` | End date (YYYY-MM-DD) |
| `--advertiser-id` | `<id>` | Omit it: it defaults to the advertiser this workspace is connected to, and any other advertiser is refused. |
| `--report-type` | `BASIC\|AUDIENCE\|PLAYABLE_MATERIAL\|CATALOG=BASIC` | BASIC = standard metrics, AUDIENCE = demographic breakdown |
| `--data-level` | `AUCTION_CAMPAIGN\|AUCTION_ADGROUP\|AUCTION_AD=AUCTION_CAMPAIGN` | Reporting level |
| `--dimensions` | `'<json>'` | Grouping dimensions: campaign\_id, adgroup\_id, ad\_id, stat\_time\_day, country\_code, gender, age, etc. |
| `--metrics` | `'<json>'` | Metrics: spend, impressions, clicks, conversions, ctr, cpc, cpm, reach, frequency, video\_views\_p25/p50/p75/p100 |
| `--filters` | `'<json>'` | |
| `--page` | `<min 1>=1` | The next page, from the previous output. |
| `--page-size` | `<1-1000>=100` | |

## tiktok video-info

### tiktok video-info get

Get TikTok video processing status and details (duration, dimensions, format).

Beta: this command may still change.

```bash theme={null}
adside tiktok video-info get --video-ids '<json>' [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--video-ids` (required) | `'<json>'` | Video IDs to get info for |
| `--advertiser-id` | `<id>` | Omit it: it defaults to the advertiser this workspace is connected to, and any other advertiser is refused. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.