Skip to content

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:

FieldTypeDescription
additionalInfo.isAiGeneratedbooleanSet to true if the post content was generated by AI. TikTok requires labeling AI-generated content.
additionalInfo.isDraftbooleanSet to true to upload the post as a draft to the user's TikTok inbox instead of publishing it directly.
additionalInfo.musicobjectAttach 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:

FieldTypeRequiredDescription
idstringYesThe TikTok music track ID.
artiststringYesThe name of the artist.
namestringYesThe name of the music track.
thumbnailstringYesThe thumbnail image URL of the track.