TikTok API

Postproxy publishes single videos and photo posts (up to 35 images) to a connected TikTok account. Every post requires a privacy_status.

Every request below uses the base URL https://api.postproxy.dev and an Authorization: Bearer YOUR_API_KEY header. Replace YOUR_API_KEY and the example IDs with your own.

At a glance


Platform ID	`tiktok`
Formats	`video` (default), `image`
Character limit	2,200
Media	Required
Placements	None
Comments	No (can be disabled per post)
Direct messages	No
Post chains	No

Publishing

Formats

Format	Description
`video`	Single video (default)
`image`	Photo post, up to 35 images

Video

Parameter	Type	Required	Description
`format`	string	No	`"video"` (default)
`privacy_status`	string	Yes	See privacy values
`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	Paid partnership promoting a third-party business
`brand_organic_toggle`	boolean	No	Paid partnership promoting your own brand

Media	Max size	Formats	Count	Duration
Video	4 GB	mp4, mov, av, webm	1	3 s – 10 min

A video is required. Minimum dimensions: 720×1280 px.

# Video post
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": ["prof_abc123"],
       "media": ["https://example.com/video.mp4"],
       "platforms": {
         "tiktok": {
           "privacy_status": "PUBLIC_TO_EVERYONE",
           "disable_comment": false,
           "made_with_ai": false
         }
       }
     }'

Image

Parameter	Type	Required	Description
`format`	string	Yes	`"image"`
`privacy_status`	string	Yes	See privacy values
`photo_cover_index`	integer	No	Index (0-based) of the cover photo
`auto_add_music`	boolean	No	Add music automatically
`disable_comment`	boolean	No	Disable comments on the post
`brand_content_toggle`	boolean	No	Paid partnership promoting a third-party business
`brand_organic_toggle`	boolean	No	Paid partnership promoting your own brand

Media	Max size	Formats	Count	Duration
Image	20 MB	jpg, gif	35	—

# Photo post
curl -X POST "https://api.postproxy.dev/api/posts" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "post": { "body": "Swipe through our 2026 lookbook 📸" },
       "profiles": ["prof_abc123"],
       "media": [
         "https://example.com/photo1.jpg",
         "https://example.com/photo2.jpg"
       ],
       "platforms": {
         "tiktok": {
           "format": "image",
           "privacy_status": "PUBLIC_TO_EVERYONE",
           "photo_cover_index": 0,
           "auto_add_music": true
         }
       }
     }'

Privacy status

Value	Visibility
`PUBLIC_TO_EVERYONE`	Everyone
`MUTUAL_FOLLOW_FRIENDS`	Mutual followers
`FOLLOWER_OF_CREATOR`	Followers only
`SELF_ONLY`	Private (only you)

Comments

The Comments API does not support TikTok. You can, however, disable comments on a post at publish time with disable_comment: true.

Direct messages

Not supported.

Webhooks

Subscribe with the Webhooks API:

curl -X POST "https://api.postproxy.dev/api/webhooks" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "url": "https://example.com/webhooks/postproxy",
       "events": ["platform_post.published", "platform_post.failed", "platform_post.insights"]
     }'

Events relevant to TikTok:

Event	When
`post.processed`	A post is ready to publish
`platform_post.published`	A post was published to the platform
`platform_post.failed`	A post failed to publish (retries exhausted)
`platform_post.failed_waiting_for_retry`	A publish attempt failed; will retry
`platform_post.insights`	New analytics snapshot
`profile.connected` / `.disconnected`	Connection state changed
`profile.stats`	New profile stats snapshot
`media.failed`	A media attachment failed to process

Notes

privacy_status is required on every post.
Videos must be at least 720×1280 px.
When a post is a paid partnership, set brand_content_toggle (third-party) or brand_organic_toggle (own brand) as required by TikTok.