TikTok

App · Social Media · 3 actions

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

Actions

ActionWhat it does
Get profile infoGet the connected TikTok creator's public profile: display name, avatar, and follower/like/video counts.
Post a videoPost a video to TikTok by pulling it from a public URL.
Query creator infoQuery the account's current posting options (allowed privacy levels and interaction settings) before posting a video.

Get profile info

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

Inputs

None.

Outputs

avatar_urltext
bio_descriptiontext
display_nametext
follower_countnumber
following_countnumber
likes_countnumber
open_idtext
profile_deep_linktext
union_idtext
video_countnumber
Example output
{
  "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 URLvideo_urltextRequired
A publicly reachable URL of the video file, on a domain verified for your TikTok app.
Captiontitletext
The video caption (may include #hashtags and @mentions).
Privacyprivacy_leveltext
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 commentsdisable_commenttrue/false
Turn off comments on the video.Default: false.
Disable Duetdisable_duettrue/false
Prevent others from making Duets with the video.Default: false.
Disable Stitchdisable_stitchtrue/false
Prevent others from Stitching the video.Default: false.

Outputs

publish_idtext
ID the upload/publish is tracked by.
Example output
{
  "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_disabledtrue/false
creator_nicknametext
creator_usernametext
duet_disabledtrue/false
max_video_post_duration_secnumber
privacy_level_optionslist
stitch_disabledtrue/false
Example output
{
  "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
}

On this page