3 days free on every plan · Try any plan before you pay.

Start free trialStart

BlogDevelopers

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 PostUpload (draft)
Scopevideo.publishvideo.upload
Start requestPOST /v2/post/publish/video/init/POST /v2/post/publish/inbox/video/init/
What happens nextThe video is postedThe user taps an inbox notification, edits and posts it in TikTok
Extra limitA 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:

  1. Register an app on the TikTok for Developers website.
  2. Add the Content Posting API product to the app.
  3. Turn on the Direct Post setting for the Content Posting API in your app.
  4. Get your app approved for the video.publish scope.
  5. 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

LimitWhat TikTok's docs say
Request rate"Each user access_token is limited to 6 requests per minute."
Unaudited appsPosts 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.
DraftsAt most 5 pending shares in any 24 hours
Captiontitle up to 2,200 UTF-16 runes
FormatsMP4 (recommended), WebM or MOV; H.264 (recommended), H.265, VP8 or VP9
File sizeUp to 4 GB
LengthUp to 10 minutes through the Upload Video init endpoint, per the media transfer guide; step 1 also returns each creator's own maximum
Chunks5 MB to 64 MB each, the last one up to 128 MB; 1 to 1,000 chunks
Frame rate23 to 60 FPS
Resolution360 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 APIAbondy API
Posts toAccounts that authorized your appPosters' own accounts
Your own TikTok accountYesNo
AppsTikTokTikTok, YouTube Shorts, Instagram Reels, Facebook
Rate limit6 requests a minute per user token60 calls a minute
PriceNot 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