TikTok API: how to post a video with the Content Posting API
Post a video with TikTok's Content Posting API: the scopes, the four requests, the audit and the limits, taken from TikTok's own developer docs.
By Abondy ResearchPublished Updated 7 min read
In short: TikTok's Content Posting API lets your app post a video to a TikTok account whose owner has authorized your app. You register an app, add the Content Posting API, get the video.publish scope, read the creator's settings, start the post from a URL or a file, and check its status. Until TikTok audits your app, everything it posts is private.
Every step and limit below comes from TikTok's developer docs, checked November 2026, with links. At the end we cover a different job: getting a video posted on many real accounts rather than your own, which is what our API and MCP server do.
If that second job is the one you came for, what UGC distribution is explains the idea before the code.
Two ways to post: Direct Post and Upload
The Content Posting API has two modes. Direct Post puts the video straight on the account. Upload sends it to the user's TikTok inbox as a draft, and the user finishes the post in the TikTok app.
| Direct Post | Upload (draft) | |
|---|---|---|
| Scope | video.publish | video.upload |
| Start request | POST /v2/post/publish/video/init/ | POST /v2/post/publish/inbox/video/init/ |
| What happens next | The video is posted | The user taps an inbox notification, edits and posts it in TikTok |
| Extra limit | A daily post cap per creator account, typically around 15 (see the limits below) | "at most 5 pending shares within any 24-hour period" |
Sources: Direct Post reference and Upload reference. The rest of this post follows Direct Post, which is what most people mean by posting a video through the API.
Before you write any code
From TikTok's Content Posting API get-started guide:
- Register an app on the TikTok for Developers website.
- Add the Content Posting API product to the app.
- Turn on the Direct Post setting for the Content Posting API in your app.
- Get your app approved for the
video.publishscope. - Have the user authorize your app for
video.publish. You need their access token and open ID, which you get through TikTok's Login Kit.
For drafts, use the video.upload scope in steps 4 and 5 instead (Upload get-started guide).
Step 1: Read the creator's settings
Before each post, the docs say to call the Query Creator Info endpoint:
curl --location --request POST 'https://open.tiktokapis.com/v2/post/publish/creator_info/query/' \
--header 'Authorization: Bearer act.example12345Example12345Example' \
--header 'Content-Type: application/json; charset=UTF-8'
The response includes the privacy options this creator can use and a maximum video length (max_video_post_duration_sec, 300 in the docs' example). The privacy_level you send next "must match one of the privacy_level_options returned" by this call.
Step 2: Start the post
You tell TikTok where the video is. With PULL_FROM_URL, TikTok fetches it from a link. This is the docs' example:
curl --location 'https://open.tiktokapis.com/v2/post/publish/video/init/' \
--header 'Authorization: Bearer act.example12345Example12345Example' \
--header 'Content-Type: application/json; charset=UTF-8' \
--data-raw '{
"post_info": {
"title": "this will be a funny #cat video on your @tiktok #fyp",
"privacy_level": "MUTUAL_FOLLOW_FRIENDS",
"disable_duet": false,
"disable_comment": true,
"disable_stitch": false,
"video_cover_timestamp_ms": 1000
},
"source_info": {
"source": "PULL_FROM_URL",
"video_url": "https://example.verified.domain.com/example_video.mp4"
}
}'
The link has to be on a domain or URL prefix you've verified with TikTok. Once a domain is verified, all paths under it and its subdomains count as yours, and the media transfer guide recommends verifying by adding a signature string to the domain's DNS records.
With FILE_UPLOAD, you send the bytes yourself. The post_info stays the same, and source_info describes the file:
"source_info": {
"source": "FILE_UPLOAD",
"video_size": 50000123,
"chunk_size": 10000000,
"total_chunk_count": 5
}
Either way, the response gives you a publish_id to track the post. For a file upload it also gives an upload_url.
Step 3: Upload the file (file uploads only)
Send the video to the upload_url with a PUT request. The docs' example:
curl --location --request PUT 'https://open-upload.tiktokapis.com/upload/?upload_id=67890&upload_token=Xza123' \
--header 'Content-Range: bytes 0-30567099/30567100' \
--header 'Content-Type: video/mp4' \
--data '@/path/to/file/example.mp4'
"The upload_url is valid for one hour after issuance," so upload soon after step 2.
Step 4: Check the status
Posting runs in the background. Poll with the publish_id:
curl --location 'https://open.tiktokapis.com/v2/post/publish/status/fetch/' \
--header 'Authorization: Bearer act.example12345Example12345Example' \
--header 'Content-Type: application/json; charset=UTF-8' \
--data '{
"publish_id": "v_pub_url~v2.123456789"
}'
The limits, as the docs state them
| Limit | What TikTok's docs say |
|---|---|
| Request rate | "Each user access_token is limited to 6 requests per minute." |
| Unaudited apps | Posts are restricted to private viewing (SELF_ONLY). Up to 5 users can post in a 24-hour window, and their accounts must be set to private when they post. |
| Daily posts | "Typically around 15 posts per day" per creator account, shared across all Direct Post apps. Each app also has a 24-hour cap on active creators, set from its audit application; no number is given. |
| Drafts | At most 5 pending shares in any 24 hours |
| Caption | title up to 2,200 UTF-16 runes |
| Formats | MP4 (recommended), WebM or MOV; H.264 (recommended), H.265, VP8 or VP9 |
| File size | Up to 4 GB |
| Length | Up to 10 minutes through the Upload Video init endpoint, per the media transfer guide; step 1 also returns each creator's own maximum |
| Chunks | 5 MB to 64 MB each, the last one up to 128 MB; 1 to 1,000 chunks |
| Frame rate | 23 to 60 FPS |
| Resolution | 360 to 4,096 pixels, height and width |
The unaudited rules and the daily caps come from TikTok's content sharing guidelines and the Direct Post reference. The media limits come from the media transfer guide.
Plan around the rate limit. A Direct Post makes several calls (creator info, init, at least one status check), so poll the status gently rather than in a tight loop, and handle a 429 error, which the docs name rate_limit_exceeded, by waiting and trying again.
Getting through the audit
To lift the private-only rule, your app "must undergo an audit to verify compliance with our Terms of Service." The content sharing guidelines list what the posting screen in your app must do, including:
- Show the creator's nickname.
- Let the user pick the privacy setting from a dropdown, with no default.
- Leave comments, duets and stitches off until the user turns them on.
- Show "By posting, you agree to TikTok's Music Usage Confirmation" before the post button.
- Show a preview of what will be posted.
- Send nothing to TikTok until the user has clearly agreed.
The Direct Post body has matching fields, such as privacy_level and disable_comment. Our advice: build these screens before you apply.
What the Content Posting API is for
It posts to accounts whose owners have signed in and authorized your app: your own account, or your users' accounts in a tool they use. It doesn't find people to post your video, and it covers TikTok only. With the rate and daily caps above, it's built for one account posting its own content, not for spreading one video across many accounts.
When you want many real accounts instead
That's a different job, and it's ours. With Abondy you don't post to your own TikTok account at all. Real people post your videos on their own TikTok, YouTube Shorts, Instagram Reels and Facebook accounts, and you pay per post.
Our REST API covers:
- Your credits
- Your campaigns, each campaign's stats and its orders
- Every upload, one row per post, 50 a page
- Placing post orders
- Webhooks when an upload goes live, is taken down or has its video rejected, when an order is done, when credits come back and when credits run low
The limit is 60 calls a minute. The same operations work from Claude, ChatGPT or Cursor through our MCP server. A campaign's apps and countries are set on abondy.com; a post order sent through the API can name its own. The paths, keys and request formats are on the developers page.
| TikTok Content Posting API | Abondy API | |
|---|---|---|
| Posts to | Accounts that authorized your app | Posters' own accounts |
| Your own TikTok account | Yes | No |
| Apps | TikTok | TikTok, YouTube Shorts, Instagram Reels, Facebook |
| Rate limit | 6 requests a minute per user token | 60 calls a minute |
| Price | Not covered here | $0.30 a post with an API key, from a prepaid API balance |
The two can run side by side. Post to your own account with TikTok's API, and use ours to get versions of the same video onto many other accounts. For how that fits a launch, see how to promote an app on TikTok.
Where Abondy fits
If your code should get a video posted by real people rather than by your own account, get a key on the developers page, or add the MCP server to your AI assistant. Plans start at $20 a month (pricing).
Questions people ask
Can you post a video to TikTok with an API?
Yes. TikTok's Content Posting API posts videos to accounts that have authorized your app for the video.publish scope. You start the post from a verified URL or a file upload, then check its status with the publish_id.
Why are my TikTok API posts private?
Your app hasn't passed TikTok's audit yet. TikTok's docs say all content posted by unaudited clients is restricted to private viewing, up to 5 users can post in 24 hours, and their accounts must be private when they post.
How many videos can I post with the TikTok API?
Each user access token is limited to 6 requests a minute, and TikTok's content sharing guidelines put the daily post cap at typically around 15 posts per creator account. Drafts sent with the Upload mode are capped at 5 pending shares in any 24 hours.
Does Abondy's API post to my own TikTok account?
No. Real posters post the videos on their own accounts on four apps. To post on your own account from code, use TikTok's Content Posting API.
Read next
- UGC distribution · 17 Nov 2026 · 7 min read
What is UGC distribution? Getting one video on hundreds of accounts
UGC distribution means paying real people to post your video, or versions of it, on their own accounts. How it works, what it costs and what to check.
- Playbooks · 17 Nov 2026 · 7 min read
How to promote an app on TikTok in 2026
Promote an app on TikTok with short screen-recorded demos, posted in volume across many accounts and judged on installs, with our data on what posts get.
- UGC distribution · 17 Nov 2026 · 8 min read
TikTok Promote vs paying people to post your video: what you get
TikTok Promote pays TikTok to show one of your posts to more people. Paying people to post gets many posts on other accounts. What each one buys.
