How to Schedule TikTok Posts via API: Complete Developer Guide

Why Schedule TikTok Posts Programmatically?

TikTok has over 1.5 billion monthly active users and the highest engagement rates of any social platform. Yet its API remains one of the most complex to work with — requiring app approval, managing OAuth flows, handling video processing, and navigating strict content restrictions. For developers and marketing teams trying to automate TikTok publishing, the barrier to entry is frustratingly high.

This guide shows you how to schedule TikTok posts via the Publora API — a unified REST endpoint that abstracts away TikTok's OAuth complexity, video processing requirements, and app review process. Whether you are building a social media management tool, automating content pipelines, or simply want to schedule TikTok videos from your own code, this walkthrough covers everything you need.

What you'll learn in this guide:

• TikTok's API requirements — Business account, video specs, app audit rules
• How to connect TikTok to Publora and get your platform ID
• Complete code examples in JavaScript and Python for scheduling posts
• The media upload flow — presigned URLs, video upload, processing
• Platform quirks, rate limits, and commercial content disclosure rules

TikTok API Requirements: What You Need Before Starting

Before writing a single line of code, you need to understand what TikTok demands from API integrations. TikTok's Content Posting API has stricter requirements than most social platforms.

TikTok Video Specifications

Getting the video specs right is essential. TikTok will reject uploads that do not meet its requirements, and the error messages are not always clear. Here is the complete reference for TikTok API video specifications.

Specification	API Limit	Native App Limit
Maximum duration	10 minutes (600s)	60 minutes
Minimum duration	3 seconds	3 seconds
Maximum file size	4 GB	4 GB
Recommended format	MP4, MOV, WebM	MP4, MOV, WebM
Minimum frame rate	23 FPS	23 FPS
Recommended aspect ratio	9:16 (vertical)	9:16 (vertical)
Caption length	2,200 characters	4,000 characters

Connect TikTok to Publora

Connecting your TikTok account to Publora is a one-time setup done through the dashboard. Once connected, you receive a platform ID in the format tiktok-{openId} that you will use in all API calls.

1. Open the Publora Dashboard — Navigate to app.publora.com and log in.
2. Go to Connections — Click "Connections" in the left sidebar, then click "+ Add Connection".
3. Select TikTok — Choose TikTok from the platform list. You will be redirected to TikTok's OAuth consent screen.
4. Authorize the connection — Grant Publora permission to post on your behalf. TikTok will request scopes for video publishing and user info.
5. Copy your platform ID — Once authorized, your TikTok account appears in the Connections list with its platform ID (e.g., tiktok-99887766). Note this for API calls.

Scheduling TikTok Posts via Publora API

With your TikTok account connected, you can now create and schedule posts using the Publora REST API. The flow is straightforward: create the post with metadata and scheduling time, then upload the video file separately.

JavaScript Example

// Step 1: Create the post with scheduling and TikTok settings
const response = await fetch('https://api.publora.com/api/v1/create-post', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-publora-key': 'sk_YOUR_API_KEY'
  },
  body: JSON.stringify({
    content: 'How we grew from 0 to 10K followers in 30 days #growthhacking #startup #tiktokmarketing',
    platforms: ['tiktok-99887766'],
    scheduledTime: '2026-04-10T14:00:00Z',
    platformSettings: {
      tiktok: {
        viewerSetting: 'PUBLIC_TO_EVERYONE',
        allowComments: true,
        allowDuet: false,
        allowStitch: false,
        commercialContent: false,
        brandOrganic: false,
        brandedContent: false
      }
    }
  })
});

const { postGroupId } = await response.json();
console.log('Post created:', postGroupId);

// Step 2: Get presigned upload URL
const uploadRes = await fetch(
  `https://api.publora.com/api/v1/upload-media/${postGroupId}?filename=growth-story.mp4`,
  { headers: { 'x-publora-key': 'sk_YOUR_API_KEY' } }
);
const { uploadUrl } = await uploadRes.json();

// Step 3: Upload the video
const videoBuffer = fs.readFileSync('growth-story.mp4');
await fetch(uploadUrl, {
  method: 'PUT',
  headers: { 'Content-Type': 'video/mp4' },
  body: videoBuffer
});
console.log('Video uploaded! Post scheduled for', '2026-04-10T14:00:00Z');

Python Example

import requests

API_KEY = 'sk_YOUR_API_KEY'
BASE = 'https://api.publora.com/api/v1'
headers = {'Content-Type': 'application/json', 'x-publora-key': API_KEY}

# Step 1: Create the post
resp = requests.post(f'{BASE}/create-post', headers=headers, json={
    'content': 'How we grew from 0 to 10K followers in 30 days #growthhacking #startup',
    'platforms': ['tiktok-99887766'],
    'scheduledTime': '2026-04-10T14:00:00Z',
    'platformSettings': {
        'tiktok': {
            'viewerSetting': 'PUBLIC_TO_EVERYONE',
            'allowComments': True,
            'allowDuet': False,
            'allowStitch': False,
            'commercialContent': False,
            'brandOrganic': False,
            'brandedContent': False
        }
    }
})
post_group_id = resp.json()['postGroupId']
print(f'Post created: {post_group_id}')

# Step 2: Get upload URL
upload_resp = requests.get(
    f'{BASE}/upload-media/{post_group_id}?filename=growth-story.mp4',
    headers={'x-publora-key': API_KEY}
)
upload_url = upload_resp.json()['uploadUrl']

# Step 3: Upload video
with open('growth-story.mp4', 'rb') as f:
    requests.put(upload_url, headers={'Content-Type': 'video/mp4'}, data=f)
print('Video uploaded! Post scheduled.')

The Media Upload Flow

TikTok's API requires a multi-step upload process. Publora simplifies this into three steps using presigned URLs — the same flow used across all 11 supported platforms.

The presigned URL is a temporary, signed URL that allows you to upload directly to cloud storage without going through Publora's servers. This means faster uploads and no file size limits imposed by Publora — only TikTok's own 4 GB maximum applies.

TikTok Platform Settings Deep Dive

TikTok's API provides extensive control over how your video is published. These settings are passed in the platformSettings.tiktok object when creating a post.

Viewer Settings (Privacy)

Controls who can see your published video. This setting is effectively required — omitting it will cause a validation error.

Value	Who Can View	Use Case
PUBLIC_TO_EVERYONE	Anyone on TikTok	Standard public posts
MUTUAL_FOLLOW_FRIENDS	Mutual followers only	Close friends content
FOLLOWER_OF_CREATOR	Your followers only	Exclusive content
SELF_ONLY	Only you	Drafts and testing

Interaction Controls

Commercial Content Disclosure

TikTok requires disclosure when your content promotes a brand or involves paid partnerships. If commercialContent is true, you must also set at least one of the following:

// Example: Sponsored post with commercial content disclosure
const response = await fetch('https://api.publora.com/api/v1/create-post', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-publora-key': 'sk_YOUR_API_KEY'
  },
  body: JSON.stringify({
    content: 'Loving the new @brandname headphones! #ad #sponsored #tech',
    platforms: ['tiktok-99887766'],
    scheduledTime: '2026-04-12T16:00:00Z',
    platformSettings: {
      tiktok: {
        viewerSetting: 'PUBLIC_TO_EVERYONE',
        allowComments: true,
        allowDuet: false,
        allowStitch: false,
        commercialContent: true,
        brandOrganic: false,
        brandedContent: true  // This is a paid partnership
      }
    }
  })
});

TikTok Rate Limits and API Restrictions

TikTok enforces strict rate limits that differ significantly from other platforms. Plan your automation schedule around these constraints.

Limit Type	Value	Notes
Posts per day	15-20	Varies by account standing
Videos per minute	Max 2	Burst limit for rapid posting
Caption length	2,200 chars	Native app allows 4,000
Max file size	4 GB	Same as native app
Video duration	3s - 10 min	Per-account limit may vary

Common Error Messages and Solutions

Platform Quirks You Need to Know

TikTok's API has several behaviors that can catch developers off guard. Here are the most important quirks to keep in mind.

Scheduling Strategy: When to Post on TikTok

TikTok's algorithm is less time-sensitive than platforms like Twitter, but posting at optimal times still improves initial engagement — which feeds into the algorithm's distribution decisions.

# Schedule a week of TikTok content
import requests
from datetime import datetime, timedelta

API_KEY = 'sk_YOUR_API_KEY'
BASE = 'https://api.publora.com/api/v1'
headers = {'Content-Type': 'application/json', 'x-publora-key': API_KEY}

videos = [
    {'file': 'day1-tutorial.mp4', 'caption': 'Day 1: Getting started #tutorial'},
    {'file': 'day2-tips.mp4', 'caption': 'Day 2: Pro tips #tips'},
    {'file': 'day3-results.mp4', 'caption': 'Day 3: Results so far #results'},
]

base_time = datetime(2026, 4, 14, 14, 0, 0)  # Monday at 2 PM UTC

for i, video in enumerate(videos):
    scheduled = (base_time + timedelta(days=i)).isoformat() + 'Z'

    # Create post
    resp = requests.post(f'{BASE}/create-post', headers=headers, json={
        'content': video['caption'],
        'platforms': ['tiktok-99887766'],
        'scheduledTime': scheduled,
        'platformSettings': {
            'tiktok': {
                'viewerSetting': 'PUBLIC_TO_EVERYONE',
                'allowComments': True,
                'allowDuet': False,
                'allowStitch': False
            }
        }
    })
    post_id = resp.json()['postGroupId']

    # Get upload URL and upload video
    upload_resp = requests.get(
        f'{BASE}/upload-media/{post_id}?filename={video["file"]}',
        headers={'x-publora-key': API_KEY}
    )
    upload_url = upload_resp.json()['uploadUrl']

    with open(video['file'], 'rb') as f:
        requests.put(upload_url, headers={'Content-Type': 'video/mp4'}, data=f)

    print(f'Scheduled: {video["caption"]} at {scheduled}')

Publora vs. Direct TikTok API Integration

If you are deciding between building directly against TikTok's Content Posting API or using Publora as a middleware layer, here is how they compare.

Getting Started in 5 Minutes

Ready to start scheduling TikTok posts? Here is the fastest path from zero to your first scheduled video.

1. Create a Publora account — free trial available on the Pro plan
2. Connect TikTok — Go to Connections → Add → TikTok → Authorize via OAuth
3. Get your API key — Settings → API Keys → Create Key (authentication docs)
4. Create your first post — Use the JavaScript or Python examples above
5. Upload the video — Follow the 3-step media upload flow

Frequently Asked Questions

Further Reading

• TikTok Platform Reference — Complete API documentation for TikTok via Publora
• Media Upload Workflow — Step-by-step guide to presigned URL uploads
• Create Post API Reference — Full endpoint documentation with all parameters
• Scheduling Guide — Timezone handling, optimal times, and batch scheduling
• Rate Limits Reference — Platform-by-platform rate limit comparison
• Authentication Guide — API key setup and security best practices