TikTok Specifications

TikTok supports direct scheduling of videos, single images, and multi-image albums (carousels) to connected TikTok accounts.

Supported Post Types

• Image (image): A single image post with a title and description.
• Video (video): A single video post with a caption.
• Album (album): A carousel post consisting of up to 35 images with a title and description.

Media Technical Requirements

Images & Albums

• Supported Formats: JPEG, WebP.
• Maximum File Size: 20 MB per image.
• Maximum Resolution: 1080p (1080 x 1920 px).

Videos

• Supported Formats: MP4, MOV, WEBM, AVI.
• Maximum File Size: 1 GB.
• Video Duration: Minimum 3 seconds, Maximum 10 minutes.
• Minimum Resolution: 360 x 360 px.
• Aspect Ratio:
  • 9:16 (Vertical) is highly recommended for best rendering.
  • 1:1 (Square) and 16:9 (Landscape) are also supported.

Text & Caption Limits

• Video Caption (description): Maximum 2,200 characters (including hashtags and mentions).
• Image / Album Title (title): Maximum 90 characters.
• Image / Album Description (description): Maximum 4,000 characters (including hashtags and mentions).

Extra Configurations (additionalInfo)

When scheduling posts to TikTok, you can configure the following TikTok-specific fields inside the additionalInfo object of the request body:

Field	Type	Description
additionalInfo.isAiGenerated	boolean	Set to true if the post content was generated by AI. TikTok requires labeling AI-generated content.
additionalInfo.isDraft	boolean	Set to true to upload the post as a draft to the user's TikTok inbox instead of publishing it directly.
additionalInfo.isAutoAddMusic	boolean	Set to true to automatically add music to the post.
additionalInfo.music	object	Attach a music track to the post. You can retrieve eligible music tracks using the Get TikTok Music API.

Music Attachment Object Schema

Inside the additionalInfo.music object, the following fields are supported:

Field	Type	Required	Description
id	string	Yes	The TikTok music track ID.
artist	string	Yes	The name of the artist.
name	string	Yes	The name of the music track.
thumbnail	string	Yes	The thumbnail image URL of the track.
volume	object	Yes	Volume adjustment settings for the original video and music track.
volume.video	number	Yes	Original video audio volume percentage (e.g., 50).
volume.music	number	Yes	Background music track volume percentage (e.g., 100).