Publora Tiktok

Publora — TikTok

Post and schedule TikTok video content via the Publora API.

Prerequisite: Install the publora core skill for auth setup and getting platform IDs.

Platform ID Format

tiktok-{userId} — where {userId} is assigned during OAuth account connection in the Publora dashboard.

Get your exact ID from GET /api/v1/platform-connections.

Requirements

• TikTok account connected via OAuth through the Publora dashboard
• Video is required — TikTok does not support text-only or image-only posts

Supported Content

Character Limits

Post a TikTok Video

import requests

HEADERS = { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' }

# Step 1: Create post with TikTok settings
post = requests.post('https://api.publora.com/api/v1/create-post', headers=HEADERS, json={
    'content': 'How we built our startup in 60 seconds #startup #tech #coding',
    'platforms': ['tiktok-99887766'],
    'platformSettings': {
        'tiktok': {
            'viewerSetting': 'PUBLIC_TO_EVERYONE',
            'allowComments': True,
            'allowDuet': True,
            'allowStitch': True,
            'commercialContent': False,
            'brandOrganic': False,
            'brandedContent': False
        }
    }
}).json()
post_group_id = post['postGroupId']

# Step 2: Get upload URL
upload = requests.post('https://api.publora.com/api/v1/get-upload-url', headers=HEADERS, json={
    'fileName': 'video.mp4', 'contentType': 'video/mp4',
    'type': 'video', 'postGroupId': post_group_id
}).json()

# Step 3: Upload to S3
with open('video.mp4', 'rb') as f:
    requests.put(upload['uploadUrl'], headers={'Content-Type': 'video/mp4'}, data=f)

Post a Private/Restricted Video

json={
    'content': 'Preview of our upcoming feature for close friends only',
    'platforms': ['tiktok-99887766'],
    'platformSettings': {
        'tiktok': {
            'viewerSetting': 'MUTUAL_FOLLOW_FRIENDS',
            'allowComments': True,
            'allowDuet': False,
            'allowStitch': False,
            'commercialContent': False,
            'brandOrganic': False,
            'brandedContent': False
        }
    }
}

Schedule a TikTok Post

json={
    'content': 'Day in the life of a founder 📱 #founder #startup #dayinthelife',
    'platforms': ['tiktok-99887766'],
    'scheduledTime': '2026-03-16T18:00:00.000Z',
    'platformSettings': {
        'tiktok': {
            'viewerSetting': 'PUBLIC_TO_EVERYONE',
            'allowComments': True,
            'allowDuet': True,
            'allowStitch': True,
            'commercialContent': False,
            'brandOrganic': False,
            'brandedContent': False
        }
    }
}

platformSettings Reference

Viewer Settings

Interaction Settings

Commercial Content Settings

⚠️ Important: If brandOrganic or brandedContent is true, then commercialContent must also be true. Publora returns a validation error if this rule is violated.

Platform Quirks

• Video required — TikTok rejects text-only or image-only posts
• Minimum 23 FPS — videos below this frame rate are rejected by TikTok
• MP4 only — convert other formats before uploading
• Commercial content disclosure — required for branded/sponsored content; violating TikTok guidelines risks account penalties
• SELF_ONLY posts cannot receive comments from others
• Processing time — TikTok processes videos after upload; the post may not appear immediately on the profile
• Max upload size: 512 MB

Tips for TikTok

• Vertical 9:16 format — anything else gets cropped
• Hook in first 1–3 seconds — critical for watch time and algorithm performance
• Caption up to 2,200 chars — use it for context, but the video tells the story
• Best lengths: 7–15 seconds for viral content; 60+ for educational
• Best times: 6–10 PM weekdays; 9–11 AM weekends
• Trending sounds dramatically increase reach when applicable
• Hashtags count toward caption character limit