TikTok
Short-form video king. Watch the music, privacy, and photo-mode rules.
TikTok is a short-form video platform with specific restrictions around music, privacy, and image formats. Watch out for music copyright, privacy settings, and image-format rules for Photo Mode.
Supported Content Types
- Videos: a single video, up to 10 minutes.
- Photo Mode (Images): 1–10 images. JPG, JPEG, or WebP only, max 20 MB per image. PNG files are rejected.
Quirks & Gotchas
Privacy & Permalinks
When content is set to SELF_ONLY (Private), the API cannot return a public
permalink immediately. The permalink field will be null or internal-only — we
can't give you a link to something that doesn't publicly exist.
Music & Copyright
TikTok uses a Commercial Music Library (CML) of pre-cleared tracks, accessible
through the TikTok Music API. Direct use of trending audio from the app is
generally unavailable via API. The autoAddMusic flag lets TikTok assign
royalty-free music, though this removes control over specific tracks.
Image Sizing
Photos larger than 1920×1080 may be auto-scaled server-side for Photo Mode posts without pre-shrinking.
Review Status
TikTok frequently places posts in REVIEW status pending platform review before
publication.
Text Limits
The caption field has a maximum of 2,200 characters.
Post Options
| Field | Type | Description |
|---|---|---|
type | VIDEO | IMAGE | Defaults to VIDEO; IMAGE enables Photo Mode. |
text | string | Caption, max 2,200 characters. |
uploadIds | string[] | One video or 1–10 Photo Mode images. |
thumbnail | string | URL to an uploaded thumbnail image. |
privacy | SELF_ONLY | PUBLIC_TO_EVERYONE | MUTUAL_FOLLOW_FRIENDS | FOLLOWER_OF_CREATOR | Visibility setting. |
photoCoverIndex | number | Zero-based cover image index for Photo Mode. |
isBrandContent | boolean | Paid partnership promotion. |
isOrganicBrandContent | boolean | Creator's own business promotion. |
disableComments | boolean | Disable comments. |
disableDuet | boolean | Disable Duets. |
disableStitch | boolean | Disable Stitches. |
thumbnailOffset | number | Video cover frame offset, in milliseconds. |
isAiGenerated | boolean | Mark AI-generated content. |
autoAddMusic | boolean | Let TikTok add music to Photo Mode. |
autoScale | boolean | Scale oversized images server-side for IMAGE posts. |
uploadToDraft | boolean | Upload as a TikTok draft/inbox item. |
musicSoundInfo | object | CML music settings. |
Analytics
Profile Analytics (30-day rolling window)
impressions / impressionsUnique, views / viewsUnique, likes,
comments, postCount, followers, following.
Post Analytics (lifetime snapshot)
impressions / impressionsUnique, views / viewsUnique, likes,
comments, shares, saves (returns 0 — not provided by TikTok).
Raw Analytics Data
Account-level data includes audience age/city breakdowns, daily metrics, and engagement totals. Video-level data includes watch-through rates, impression sources (For You, Following, Search), and audience gender/country splits. TikTok can require up to 48 hours to process some detailed analytics like audience demographics.