Skip to main content

TikTok API Guide

Publish videos to TikTok with full control over privacy settings, interaction permissions, and cover thumbnails. PostEverywhere uses TikTok's Content Posting API to handle video uploads and publishing on your behalf. For a general overview of all supported platforms, see the Introduction.

Supported Content Types​

Content TypeMedia RequiredDescription
VideoVideo (MP4)Standard TikTok video. Video is always required for TikTok posts.

TikTok is a video-only platform. Every post must include at least one video attachment.

Platform-Specific Settings​

Use the platform_content.tiktok object to configure privacy and interaction settings:

{
  "platform_content": {
    "tiktok": {
      "content": "TikTok caption (max 150 chars)",
      "settings": {
        "privacyLevel": "PUBLIC_TO_EVERYONE",
        "allowComments": true,
        "allowDuet": true,
        "allowStitch": true,
        "videoCoverTimestamp": 1000
      }
    }
  }
}

Settings Reference​

SettingTypeDefaultDescription
contentstring—Override the default caption. TikTok captions are limited to 150 characters.
settings.privacyLevelstring"PUBLIC_TO_EVERYONE"Who can view the video. See values below.
settings.allowCommentsbooleantrueWhether viewers can comment on the video.
settings.allowDuetbooleantrueWhether other users can create Duets with this video.
settings.allowStitchbooleantrueWhether other users can Stitch this video.
settings.videoCoverTimestampnumber1000Timestamp in milliseconds for the cover thumbnail frame.

Privacy Levels​

ValueDescription
PUBLIC_TO_EVERYONEVisible to all TikTok users.
MUTUAL_FOLLOW_FRIENDSVisible only to mutual followers (friends).
FOLLOWER_OF_CREATORVisible only to your followers.
SELF_ONLYOnly visible to you. Useful for drafts or testing.

Example: Create a Post​

Schedule a Public TikTok Video​

curl -X POST https://app.posteverywhere.ai/api/v1/posts \
  -H "Authorization: Bearer $POSTEVERYWHERE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Quick tip for your morning routine!",
    "account_ids": [2285],
    "media_ids": ["c3d4e5f6-a7b8-9012-cdef-123456789012"],
    "scheduled_at": "2026-04-15T17:00:00Z",
    "timezone": "America/Los_Angeles",
    "platform_content": {
      "tiktok": {
        "content": "Morning routine hack you NEED to try #morningroutine #lifehack #tips",
        "settings": {
          "privacyLevel": "PUBLIC_TO_EVERYONE",
          "allowComments": true,
          "allowDuet": true,
          "allowStitch": false,
          "videoCoverTimestamp": 2500
        }
      }
    }
  }'

Schedule a Private Test Video​

curl -X POST https://app.posteverywhere.ai/api/v1/posts \
  -H "Authorization: Bearer $POSTEVERYWHERE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Testing new content format",
    "account_ids": [2285],
    "media_ids": ["d4e5f6a7-b8c9-0123-def0-234567890123"],
    "platform_content": {
      "tiktok": {
        "settings": {
          "privacyLevel": "SELF_ONLY",
          "allowComments": false,
          "allowDuet": false,
          "allowStitch": false
        }
      }
    }
  }'

Requirements & Limits​

RequirementLimit
Caption length150 characters
Video formatMP4 (H.264)
Video max file size500 MB
Video duration3 seconds - 10 minutes
Video resolutionMinimum 720p recommended
Recommended aspect ratio9:16 (vertical, 1080x1920)
Cover timestampSpecified in milliseconds

Tips​

  • Set videoCoverTimestamp to a visually compelling frame. The cover thumbnail is the first thing users see when scrolling. Pick a frame that teases the content — default is 1000ms (1 second).
  • Use SELF_ONLY for testing. Schedule a private video first to verify the upload looks correct on TikTok before changing the privacy level and reposting publicly.
  • Keep captions short and hashtag-heavy. TikTok's 150-character limit means every character counts. Put your hook in the first few words and use trending hashtags for discoverability.

Frequently Asked Questions​

Can I control who can Duet or Stitch my TikTok video?​

Yes. Set allowDuet and allowStitch to true or false in the platform_content.tiktok.settings object. Both default to true. You can disable them individually to prevent other users from creating Duets or Stitches with your content.

What privacy levels are available for TikTok posts?​

TikTok supports four privacy levels: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS (mutual followers only), FOLLOWER_OF_CREATOR (your followers only), and SELF_ONLY (only you). Set the privacyLevel field when creating a post.

How do I choose the cover thumbnail for my TikTok video?​

Use the videoCoverTimestamp setting, specified in milliseconds. For example, 2500 selects the frame at 2.5 seconds. If omitted, TikTok uses the frame at 1000ms (1 second) by default.

What video format does TikTok require?​

TikTok requires MP4 (H.264) video files. Videos can be 3 seconds to 10 minutes long, up to 500 MB. The recommended aspect ratio is 9:16 vertical (1080x1920) with a minimum resolution of 720p. Upload your video before creating the post.

  • Instagram -- Reels share the same vertical video format (9:16)
  • YouTube -- YouTube Shorts are a similar short-form vertical video format
  • Facebook -- Facebook Reels also use 9:16 vertical video

Further Reading​