Appearance
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.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. |
