TikTok Upload API

This section details how to upload videos and photos (carousels) to TikTok using the API.

Base URL

https://api.multi-upload-tool.com/api/v1

Authentication

All requests require an API Token in the header: x-api-key: YOUR_API_TOKEN

Requirements

TikTok Video Requirements

Supported Formats: MP4 (recommended), WebM, MOV
Supported Codecs: H.264 (recommended), H.265, VP8
Framerate: Minimum: 23 FPS, Maximum: 60 FPS
Picture Size: Minimum: 360 pixels (height and width), Maximum: 4096 pixels (height and width)
Duration: Maximum via API: 10 minutes. (Note: All TikTok creators can post 3-minute videos. Some creators have access to 5-minute or 10-minute videos. Users may trim videos in the TikTok app.)
Size: Maximum: 4GB

TikTok Photo Requirements

Formats: JPG, JPEG, WEBP.
Aspect Ratio: 9:16 required. Images that don’t match this ratio are automatically padded/resized to 1080x1920 pixels.
Max Images: Up to 35 images per carousel.

Validation & Limits

The following limits are enforced by our API:

Constraint	Limit	Notes
Video file size	4 GB	Enforced by API. Files over 100 MB must use presigned uploads — a single request is capped at 100 MB by our edge.
Image file size	20 MB per image	Enforced by API
Video caption/description	2,200 characters	Max character length enforced
Photo title	90 UTF-16 runes	Max title length for carousel; longer values truncated
Photo caption/description	2,200 characters	Max character length enforced
Photo carousel	Up to 35 images	Per TikTok API specification
Privacy levels	`PUBLIC_TO_EVERYONE`, `MUTUAL_FOLLOW_FRIENDS`, `FOLLOWER_OF_CREATOR`, `SELF_ONLY`	If requested level unavailable for creator account, falls back to `SELF_ONLY`
Caption requirement	Non-empty	Both video and photo posts require at least one non-whitespace character in caption

Recommended by TikTok (not enforced by us):

Video aspect ratio: 9:16 (vertical) is optimal; 16:9 or 1:1 supported
Video minimum duration: 3 seconds
Photo aspect ratio: 9:16 required by TikTok (auto-padded to 1080×1920 if needed)

Source: TikTok Content Posting API — Media Transfer Guide

Upload Video

Upload a single video file to TikTok.

Endpoint

POST /upload

Content-Type

multipart/form-data

Parameters

Query Parameters

Parameter	Type	Required	Description
`async`	string	No	Default `"true"`. If `"false"`, the API waits for upload completion. Passed as a query string value.

Body Parameters

Parameter	Type	Required	Description
`accountId`	string	Yes	The ID of the connected TikTok account.
`video`	File	Yes	The video file (MP4, WebM).
`title`	string	Yes*	The caption of the post. *A `title`, `description` or `caption` is required.
`description`	string	No	For a video, takes precedence over `title` as the caption. For a photo carousel, the post description (`title` is the carousel title).
`schedule_date`	string	No	ISO 8601 date string to schedule the post (e.g., `2025-12-25T10:00:00Z`). Must be in the future and within 6 months.
`privacy_level`	string	No	`PUBLIC_TO_EVERYONE` (default), `MUTUAL_FOLLOW_FRIENDS`, `FOLLOWER_OF_CREATOR`, `SELF_ONLY`. If the requested level is not available for the creator, falls back to `SELF_ONLY`.
`disable_comment`	boolean \| string	No	Disable comments on the post. Accepts `true`/`false` or `"true"`/`"false"`.
`disable_duet`	boolean \| string	No	Disable Duet feature.
`disable_stitch`	boolean \| string	No	Disable Stitch feature.
`brand_content_toggle`	boolean \| string	No	Mark as branded content.
`brand_organic_toggle`	boolean \| string	No	Mark as organic branded content.
`is_aigc`	boolean \| string	No	Mark as AI-Generated Content (AIGC).
`video_cover_timestamp_ms`	number	No	Timestamp (in ms) for the video cover image.
`post_mode`	string	No	`DIRECT_POST` (default) or `MEDIA_UPLOAD`: the video goes to the creator’s TikTok inbox instead of being published, and they finish the post in the app. TikTok allows at most 5 pending inbox posts per 24 hours.

Example Request


curl -X POST https://api.multi-upload-tool.com/api/v1/upload \
  -H "x-api-key: YOUR_API_TOKEN" \
  -F "accountId=cmf3k9x2a0001l408q7vbn2hd" \
  -F "video=@/path/to/video.mp4" \
  -F "title=My amazing video #tiktok" \
  -F "privacy_level=PUBLIC_TO_EVERYONE" \
  -F "is_aigc=false"

Example Response


{
  "success": true,
  "message": "Upload queued successfully",
  "data": {
    "uploadId": 456,
    "status": "pending",
    "scheduledFor": null
  }
}

Scheduled post: If schedule_date is provided, status will be "scheduled" and scheduledFor will contain the ISO date.

Upload Photos (Carousel)

Upload multiple photos to create a TikTok carousel.