Publora Youtube

Upload and publish video content to YouTube using the Publora API. Use this skill when the user wants to upload or schedule YouTube videos via Publora.

YouTube platform skill for the Publora API. For auth, core scheduling, media upload, and workspace/webhook docs, see the publora core skill.

Base URL: https://api.publora.com/api/v1
Header: x-publora-key: sk_YOUR_KEY
Platform ID format: youtube-{channelId}

Platform Limits (API)

Property	Limit	Notes
Title	100 characters	—
Description	5,000 characters	First 150 chars visible
Video duration	12 hours	—
Video size	256 GB	—
Video formats	MP4, MOV, AVI, WebM	—
Images	❌ Video only	—
Text only	❌ Video required	—
Privacy	public / unlisted / private	Default: public

Upload a YouTube Video

YouTube requires video and supports privacy settings and metadata:

// Step 1: Create post with YouTube-specific platform settings
const post = await fetch('https://api.publora.com/api/v1/create-post', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },
  body: JSON.stringify({
    content: 'Your video description here. Full details about what this video covers.',
    platforms: ['youtube-UC_CHANNEL_ID'],
    scheduledTime: '2026-03-20T15:00:00.000Z'
  })
}).then(r => r.json());

// Step 2: Get upload URL
const upload = await fetch('https://api.publora.com/api/v1/get-upload-url', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'x-publora-key': 'sk_YOUR_KEY' },
  body: JSON.stringify({
    postGroupId: post.postGroupId,
    fileName: 'video.mp4',
    contentType: 'video/mp4',
    type: 'video'
  })
}).then(r => r.json());

// Step 3: Upload video to S3
await fetch(upload.uploadUrl, {
  method: 'PUT',
  headers: { 'Content-Type': 'video/mp4' },
  body: videoFileBytes
});

Python Example

import requests

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

# Step 1: Create post (content = video description)
post = requests.post('https://api.publora.com/api/v1/create-post', headers=HEADERS, json={
    'content': 'Complete guide to building REST APIs in 2026. We cover authentication, rate limiting, and best practices.',
    'platforms': ['youtube-UC_CHANNEL_ID'],
    'scheduledTime': '2026-03-20T15:00:00.000Z'
}).json()

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

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

print(f"Scheduled: {post['postGroupId']}")

Platform Quirks

• Video only — YouTube does not support images or text-only posts
• content field = description — the content field maps to the YouTube video description
• Title: Set via platform settings (defaults to first line of description if not set)
• Privacy: Defaults to public. Can be set to unlisted or private via platform settings
• YouTube Shorts: Videos under 60 seconds in portrait orientation (9:16) are automatically treated as Shorts
• Large files: 256 GB max — YouTube is the most generous platform for file size
• Processing time: YouTube processes uploaded videos before they go live; scheduling accounts for this