​

TikTok

​

API overview

​

Use cases

• Publish short-form promotional videos.
• Publish photo posts with a cover image and a title.
• Tune interaction controls such as comments, duet, and stitch.

​

When to use

• When the content is a short-form video or photo post.
• When you need to control duet, stitch, or comment behavior.

​

When not to use

• When you need a long-form or multi-video workflow.
• When the account does not support the interaction options you need.

​

Examples

​

Video post

{
  "platforms": [
    {
      "platform": "tiktok",
      "accountId": "tiktok_123",
      "content": "Launch day teaser.",
      "mediaItems": [
        {
          "type": "video",
          "url": "https://cdn.postova.dev/launch.mp4"
        }
      ],
      "settings": {
        "tiktok": {
          "privacy_level": "PUBLIC_TO_EVERYONE",
          "allow_comment": false,
          "allow_duet": true,
          "allow_stitch": false
        }
      }
    }
  ]
}

​

How to post

1. Connect a TikTok creator account.
2. Provide video or photo media with the post content.
3. Adjust privacy and interaction settings when needed.

​

Authentication

​

Default scopes

​

Supported media

• image
• video
• Supports image and video publishing.

​

Settings

​

Common errors

• Unsupported privacy level: The provided privacy level does not match what the creator account accepts. Fix: Use a supported privacy level and let the creator account override where required.

​

Constraints

• Photo posts and video posts use different payloads in the worker.
• Some privacy and interaction options can be overridden by the creator account.

​

Notes

• Validation is permissive and keeps unknown settings keys.