Log inStart Free Trial
easyCoexistence Official APIs

TikTok video requirements for the API: format, size and length

A video published through TikTok's API for Business must be an MP4, MOV or WebM file of up to 1 GB, 3 to 600 seconds long (or the account's lower maximum), at least 360 pixels in height and width, at 23 to 60 frames per second. TikTok downloads the file itself, so the video URL must sit on a domain or URL prefix the publishing app has verified.

easyCoexistence publishes TikTok videos with publish_tiktok_post from Claude, ChatGPT or your own code: pass an HTTPS link to the file, the caption and whether comments are on, and it serves the file to TikTok from its own verified media route.

1 GB

Largest video the publish endpoint accepts, in an MP4, MOV or WebM container.

3 to 600 s

Shortest and longest video durations TikTok documents for publishing through the API.

360 px

Minimum height and width of a published video, which also needs 23 to 60 frames per second.

30 min

Minimum time TikTok recommends the video URL stays valid, since TikTok downloads the file itself.

What does a video have to meet?

TikTok's specification for a video published through POST /business/video/publish/, which TikTok checks once it has downloaded the file:

  • Container: MP4, MOV or WebM.
  • Size: up to 1 GB.
  • Length: at least 3 seconds and at most 600, or less where the account's own maximum is lower.
  • Picture: at least 360 pixels in both height and width.
  • Frame rate: from 23 to 60 frames per second.

Can every account publish 600-second videos?

Not always. GET /business/video/settings/ returns max_video_post_duration_sec, the longest video the account itself can publish, and a longer one fails to publish. The same call reports whether the account's settings allow comments, Duets and Stitch on its posts. With easyCoexistence, your own code reads it with the token and business_id from get_social_credentials.

Where does the video have to be?

At a public HTTP or HTTPS URL, which TikTok fetches itself and recommends keeping valid for at least 30 minutes. Since November 16, 2023, TikTok also refuses video URLs that are not verified: the developer proves ownership of a domain with a DNS TXT record, or of a URL prefix with a signature file placed under it, and any URL that begins with a verified prefix can then be published from.

How does easyCoexistence get your file to TikTok?

Through its own verified URL prefix. publish_tiktok_post takes your HTTPS link, hands TikTok a signed link under easyCoexistence's media route that expires after 6 hours, and streams the file from your link when TikTok downloads it, storing nothing on the way. Your link needs no verification of its own, but it has to be HTTPS and open without a login until the post is published.

What happens after TikTok downloads the video?

TikTok checks the file and transcodes it, and notes that the published post can show a lower resolution and bit rate than the original, depending on the viewer's device and network. A file that breaks a rule does not publish: its status reads FAILED with a reason such as file_format_check_failed, frame_rate_check_failed or picture_size_check_failed, and TikTok marks these as not retryable with the same file.

Common mistakes

  • Sending an http:// link. publish_tiktok_post takes HTTPS links only and refuses the call before TikTok sees it.
  • Exporting below 23 frames per second. TikTok downloads the file, finds the frame rate too low and fails the post with frame_rate_check_failed.
  • Assuming 600 seconds for every account. A video longer than the account's max_video_post_duration_sec fails, so check it first.
  • Taking the file down right after the call. TikTok downloads it after accepting the request, and a link that stops working fails with video_pull_failed.
Doing this with EasyCoexistence

US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.

easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.

Frequently asked questions

Which video formats does TikTok's API accept?

MP4, MOV and WebM files of up to 1 GB, from 3 to 600 seconds long, at least 360 pixels on each side and 23 to 60 frames per second.

Can I upload a video file from my computer?

Not to this endpoint. It takes a video_url and downloads the file from there, so the video needs a public HTTPS link first.

Why does TikTok want a verified URL?

TikTok says verifying URL ownership helps it comply with its policies on copyrighted content and user safety, and since November 16, 2023 it has refused unverified video URLs.

Does TikTok lower the quality of an API-published video?

It can. TikTok transcodes the video, and the post may show a lower resolution and bit rate than the file, depending on the viewer's device and connection.

Keep reading

Connect your first channel in two minutes.

No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.

  • 3 days free
  • Cancel any time
  • Official APIs only
  • Monitored 24/7

Verified on