# TikTok

> Read your TikTok profile and creator options, and post videos from a URL.

App · Social Media · 3 actions. Web page: https://docs.lodol.com/docs/integrations/tiktok

## Actions

### Get profile info

Get the connected TikTok creator's public profile: display name, avatar, and follower/like/video counts.

**Inputs**: None.

**Outputs**

- `avatar_url` (text)
- `bio_description` (text)
- `display_name` (text)
- `follower_count` (number)
- `following_count` (number)
- `likes_count` (number)
- `open_id` (text)
- `profile_deep_link` (text)
- `union_id` (text)
- `video_count` (number)

**Example output**

```json
{
  "avatar_url": "https://p16.tiktokcdn.com/avatar.jpeg",
  "display_name": "Lodol Creator",
  "follower_count": 1200,
  "following_count": 80,
  "likes_count": 34000,
  "open_id": "_000abc123",
  "video_count": 42
}
```

### Post a video

Post a video to TikTok by pulling it from a public URL. The URL's domain must be verified on your TikTok app. Publishing then completes asynchronously on TikTok.

**Inputs**

- Video URL (`video_url`, text, required): A publicly reachable URL of the video file, on a domain verified for your TikTok app.
- Caption (`title`, text): The video caption (may include #hashtags and @mentions).
- Privacy (`privacy_level`, text): Who can see the video. Must be one your account allows (see Query creator info). One of: `PUBLIC_TO_EVERYONE` (Public), `FOLLOWER_OF_CREATOR` (Followers only), `MUTUAL_FOLLOW_FRIENDS` (Friends (mutual follows)), `SELF_ONLY` (Private (only me)). Default: `SELF_ONLY`.
- Disable comments (`disable_comment`, true/false): Turn off comments on the video. Default: `false`.
- Disable Duet (`disable_duet`, true/false): Prevent others from making Duets with the video. Default: `false`.
- Disable Stitch (`disable_stitch`, true/false): Prevent others from Stitching the video. Default: `false`.

**Outputs**

- `publish_id` (text): ID the upload/publish is tracked by.

**Example output**

```json
{
  "publish_id": "v_pub_url~v2.123456789"
}
```

### Query creator info

Query the account's current posting options (allowed privacy levels and interaction settings) before posting a video.

**Inputs**: None.

**Outputs**

- `comment_disabled` (true/false)
- `creator_nickname` (text)
- `creator_username` (text)
- `duet_disabled` (true/false)
- `max_video_post_duration_sec` (number)
- `privacy_level_options` (list)
- `stitch_disabled` (true/false)

**Example output**

```json
{
  "comment_disabled": false,
  "creator_nickname": "Lodol Creator",
  "creator_username": "lodolcreator",
  "duet_disabled": false,
  "max_video_post_duration_sec": 600,
  "privacy_level_options": [
    "PUBLIC_TO_EVERYONE",
    "MUTUAL_FOLLOW_FRIENDS",
    "SELF_ONLY"
  ],
  "stitch_disabled": false
}
```