Query creator info [#1-query-creator-info]
TikTok requires that the `privacyLevel` you set matches one of the options available for the target account. Call this endpoint to get the current settings.
```bash
GET /api/v1/accounts/{accountId}/tiktok-creator-info
```
The response depends on the account type:
**Public account:**
```json
{
"privacyLevelOptions": ["PUBLIC_TO_EVERYONE", "MUTUAL_FOLLOW_FRIENDS", "SELF_ONLY"],
"commentDisabled": false,
"duetDisabled": false,
"stitchDisabled": false,
"maxVideoPostDurationSec": 600
}
```
**Private account:**
```json
{
"privacyLevelOptions": ["FOLLOWER_OF_CREATOR", "MUTUAL_FOLLOW_FRIENDS", "SELF_ONLY"],
"commentDisabled": false,
"duetDisabled": true,
"stitchDisabled": true,
"maxVideoPostDurationSec": 180
}
```
If `duetDisabled` or `stitchDisabled` is `true`, TikTok will ignore the corresponding `disableDuet`/`disableStitch` settings.
Get your media ready [#2-get-your-media-ready]
```bash
curl -X POST https://publishq.com/api/v1/media \
-H "Authorization: Bearer pq_live_..." \
-F "file=@video.mp4"
```
```bash
curl https://publishq.com/api/v1/media \
-H "Authorization: Bearer pq_live_..."
```
Pick the `id` of the video you want to use from the response.
Create the post [#3-create-the-post]
The caption goes in `content` (max 2200 characters). Hashtags (`#`) and mentions (`@`) in the caption are automatically parsed by TikTok.
```json
{
"content": "New tutorial dropping 🎬 #coding #fyp",
"mediaIds": ["video-media-id"],
"thumbnailTimestamp": 3500,
"accounts": [
{
"accountId": "tiktok-account-id",
"platformSpecificSettings": {
"privacyLevel": "PUBLIC_TO_EVERYONE",
"disableComment": false,
"disableDuet": false,
"disableStitch": false,
"brandContentToggle": false,
"brandOrganicToggle": false
}
}
],
"publishNow": true
}
```
Post a photo carousel [#post-a-photo-carousel]
A swipeable photo post with 1–35 images. WebP and JPEG only, max 20 MB per image.
Query creator info [#1-query-creator-info-1]
Same as above — call the creator info endpoint to get the available privacy options.
```bash
GET /api/v1/accounts/{accountId}/tiktok-creator-info
```
Get your media ready [#2-get-your-media-ready-1]
```bash
curl -X POST https://publishq.com/api/v1/media \
-H "Authorization: Bearer pq_live_..." \
-F "file=@photo1.jpg"
```
Repeat for each image. Collect the `id` from each response.
```bash
curl https://publishq.com/api/v1/media \
-H "Authorization: Bearer pq_live_..."
```
Pick the `id`s of the images you want to use from the response.
Create the post [#3-create-the-post-1]
Attach 1–35 images. TikTok displays them as a swipeable carousel. The `content` field maps to the photo title (max 90 characters). Use `description` in `platformSpecificSettings` for longer text (max 4000 characters).
```json
{
"content": "Travel dump 🌍",
"mediaIds": ["img-1", "img-2", "img-3", "img-4", "img-5"],
"accounts": [
{
"accountId": "tiktok-account-id",
"platformSpecificSettings": {
"privacyLevel": "PUBLIC_TO_EVERYONE",
"disableComment": false,
"disableDuet": false,
"disableStitch": false,
"brandContentToggle": false,
"brandOrganicToggle": false,
"autoAddMusic": true,
"photoCoverIndex": 2,
"description": "Best spots from our trip through Southeast Asia 🇹🇭🇻🇳🇰🇭 #travel #photomode #backpacking"
}
}
],
"publishNow": true
}
```
TikTok photo posts have a **90-character title limit** (the `content` field), while video posts allow up to 2200 characters. If you're posting to TikTok alongside platforms with longer limits, use `postOverrides` to provide a shorter title just for TikTok.
```json
{
"content": "Full description of our latest product launch with all the details...",
"mediaIds": ["img-1", "img-2", "img-3"],
"accounts": [
{ "accountId": "instagram-account-id" },
{
"accountId": "tiktok-account-id",
"postOverrides": {
"content": "New product just dropped 🔥"
},
"platformSpecificSettings": {
"privacyLevel": "PUBLIC_TO_EVERYONE",
"disableComment": false,
"disableDuet": false,
"disableStitch": false,
"brandContentToggle": false,
"brandOrganicToggle": false,
"description": "Full description with all the #details and @mentions here"
}
}
],
"publishNow": true
}
```
Media specs [#media-specs]
Video [#video]
| Spec | Value |
| ----------------- | ---------------------------------------- |
| Max file size | **4 GB** |
| Min duration | **3 seconds** |
| Max duration | Varies per account (3, 5, or 10 minutes) |
| Supported formats | MP4 (recommended), WebM, MOV |
| Supported codecs | H.264 (recommended), H.265, VP8, VP9 |
| Framerate | 23–60 FPS |
| Resolution | Min 360px, max 4096px (both dimensions) |
Images [#images]
| Spec | Value |
| ------------------- | ------------------- |
| Max file size | **20 MB** per image |
| Max images per post | **35** |
| Supported formats | WebP, JPEG |
| Max resolution | 1080p |
Platform-specific settings [#platform-specific-settings]
{/* Fields auto-generated from TikTokPlatformSpecificSettingsSchema */}