TikTok

TikTok supports videos and photo posts, with options for music, drafts, and AI labels.

Post types

Type	API value	What it publishes
Image	image	A photo post with one image, a title, and a caption.
Album	album	A photo carousel of 2 to 35 images, a title, and a caption.
Video	video	One video with a caption.

Media requirements

Images

• Formats: JPEG, WebP.
• File size: up to 20 MB per image.
• Resolution: up to 1080 × 1920 px.

Videos

• Formats: MP4, MOV, WEBM, AVI.
• File size: up to 1 GB.
• Duration: 3 seconds to 10 minutes.
• Resolution: at least 360 × 360 px.
• Aspect ratio: 9:16 is recommended. 1:1 and 16:9 also work.

Text limits

• Caption (description): up to 2,200 characters, including hashtags and mentions.
• Title (title), for Image and Album posts: up to 90 characters.

Extra options

Option in the dashboard	API field	Applies to	What it does
Music	additionalInfo.music	All types	Adds a TikTok track. Find tracks with Get TikTok Music.
Auto Add Music	additionalInfo.isAutoAddMusic	Image, Album	Lets TikTok add a recommended track to the photo post. Ignored when Music is set.
AI Generated	additionalInfo.isAiGenerated	Video	Labels the video as AI-generated, as TikTok requires for AI content.
Save as Draft	additionalInfo.isDraft	All types	Sends the post to your TikTok inbox as a draft instead of publishing it.
Custom Thumbnail	medias[].thumbnail, medias[].customThumbnail	Video	Uses your own image as the video cover.

Music object

Field	Type	Description
id	string	TikTok music track ID.
artist	string	Artist name.
name	string	Track name.
thumbnail	string	Track cover image URL.
volume.video	number	Volume of the video's original sound, in percent (dashboard default 50). Video only.
volume.music	number	Volume of the track, in percent (dashboard default 100). Video only.

Only id is sent to TikTok, with volume for videos. Image and Album posts play the track at TikTok's default volume.