Postproxy × TikTok

Publish videos to TikTok with privacy controls, music settings, and engagement options. Handle AI-generated content flags and brand partnerships.

One API call handles TikTok-specific features like privacy settings, music, and engagement controls.

Privacy Settings

Control video visibility with multiple privacy options

Music Auto-add

Enable automatic music addition to your videos

AI Content Flags

Mark content as AI-generated for transparency

Engagement Controls

Manage comments, duets, and stitches settings

POST /v1/posts
Terminal window
curl -X POST "https://api.postproxy.dev/api/posts" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "post": {
         "body": "Quick tip: Building APIs just got easier! 🚀"
       },
       "profiles": ["tiktok"],
       "media": ["https://example.com/video.mp4"],
       "platforms": {
         "tiktok": {
           "privacy_status": "PUBLIC_TO_EVERYONE",
           "auto_add_music": true,
           "disable_comment": false,
           "disable_duet": false,
           "disable_stitch": false,
           "made_with_ai": false
         }
       }
     }'

TikTok Parameters

Formats

Format Description
post Feed post (default)

Parameters

Parameter Type Required Description
privacy_status string No Privacy setting for the video (PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, SELF_ONLY)
photo_cover_index integer No Index (0-based) of photo to use as cover
auto_add_music boolean No Enable automatic music
made_with_ai boolean No Mark content as AI-generated
disable_comment boolean No Disable comments on the post
disable_duet boolean No Disable duets
disable_stitch boolean No Disable stitches
brand_content_toggle boolean No Mark video as paid partnership promoting a third-party business
brand_organic_toggle boolean No Mark video as paid partnership promoting your own brand

Media Constraints

Media Type Max Size Formats Max Count Duration
Image 20 MB jpg, gif 35 -
Video 4 GB mp4, mov, av, webm 1 3s - 10min

Notes

  • Text content: Optional (caption)
  • Media required: Yes
  • Mix video and image: No
  • Minimum video dimensions: 720x1280 pixels

View full documentation for all platform-specific features for TikTok

View documentation

Why Postproxy for TikTok?

Skip TikTok API complexity

No need to handle TikTok's OAuth flows, video uploads, or API rate limits. Postproxy handles it all.

Handle rate limits automatically

TikTok rate limits are managed automatically with intelligent retry logic.

Support all formats

Publish videos with full control over privacy and engagement settings.

Supported formats:
Videos

Reliable delivery

Automatic retries and clear status reporting ensure your videos reach TikTok.

How TikTok Publishing Works with Postproxy

TikTok's publishing model

TikTok's Content Posting API uses a two-phase flow: first you initialize an upload by specifying video metadata and constraints, then you upload the video to a TikTok-provided URL. After upload, the video enters an async processing and review pipeline before it goes live. Unlike other platforms, TikTok requires you to declare content properties upfront — privacy level, whether comments and duets are allowed, and whether the content is AI-generated. Postproxy wraps this into a single request where you specify all parameters at once.

Privacy controls and content disclosure

TikTok's API requires explicit privacy settings on every post: public, friends, or private. It also mandates disclosure flags for AI-generated content and branded partnerships — failing to set these when required can result in post rejection or account penalties. Postproxy exposes these as straightforward fields in the platform parameters, with sensible defaults and validation to prevent rejected uploads.

Common gotchas Postproxy handles for you

TikTok's API has unique constraints that trip up most integrations: videos must be between 3 seconds and 10 minutes, the upload URL expires after a short window, and the processing status must be polled after upload. The API also requires specific video codecs (H.264/H.265) and has different size limits depending on the upload method (file upload vs. URL pull). Postproxy validates video constraints before upload, handles the time-sensitive upload flow, and polls for processing completion so you get a definitive success or failure response.

Engagement settings and music

Each TikTok post can independently control whether comments, duets, and stitches are enabled. These aren't just boolean flags — they interact with account-level settings and content type restrictions. Postproxy lets you set allow_comment, allow_duet, and allow_stitch per post, and validates that your settings are compatible with the account's capabilities before submitting to TikTok's API.

Frequently Asked Questions

Common questions about TikTok integration

How do I configure privacy settings for my TikTok video?

Use the `privacy_status` parameter with values: "PUBLIC_TO_EVERYONE" (visible to all), "MUTUAL_FOLLOW_FRIENDS" (mutual followers only), "FOLLOWER_OF_CREATOR" (followers only), or "SELF_ONLY" (private).

Can I disable comments on my TikTok post?

Yes! Set `disable_comment` to `true` in the platforms object. You can also disable duets (`disable_duet`) and stitches (`disable_stitch`) separately.

Does TikTok support automatic music addition?

Yes! Set `auto_add_music` to `true` to enable automatic music addition. TikTok will automatically add trending music to your video if no audio is detected.

Can I mark my content as AI-generated?

Yes! Use the `made_with_ai` parameter set to `true` to mark your video as AI-generated. This helps with transparency and compliance.

What video formats and sizes are supported?

TikTok supports mp4, mov, av, and webm formats. Videos can be up to 4 GB in size and must be between 3 seconds and 10 minutes long. Minimum dimensions are 720x1280 pixels.

Ready to get started?

Start with our free plan and scale as your needs grow. No credit card required.

Get started View documentation