upload-post/upload-post-skill

Overview

This skill uploads content to multiple social platforms using the Upload-Post API. It supports videos, photos, text posts, and LinkedIn documents, plus scheduling, analytics, FFmpeg media processing, and upload history. Use a single API key and profile name to target connected accounts across TikTok, Instagram, YouTube, LinkedIn, Facebook, X, Threads, Pinterest, Reddit, and Bluesky.

How this skill works

Authenticate requests with Authorization: Apikey YOUR_API_KEY and provide the profile name as the user parameter to route posts to your connected accounts. Use dedicated endpoints to upload videos, photos, text, or documents; schedule posts with ISO-8601 dates; check async status or job_id for scheduled work; and call the analytics and history endpoints to retrieve performance and upload records. A separate FFmpeg endpoint lets you run custom processing commands and retrieve processed outputs.

When to use it

• Publish the same post across multiple platforms in one call to save time.
• Schedule campaigns in advance and manage or cancel scheduled jobs programmatically.
• Upload large or long videos that require background (async) processing or FFmpeg edits.
• Post native LinkedIn documents (PDF/PPT/DOC) as carousel viewers.
• Aggregate upload history and analytics for reporting or auditing.

Best practices

• Create and reuse a Profile (profile name) that links all desired social accounts before calling the API.
• Always validate the API key with GET /uploadposts/me and check platform availability for your profile.
• Use async_upload for heavy processing and poll the status endpoint with request_id to avoid timeouts.
• Respect platform-specific media requirements (format, size, duration) and use the FFmpeg endpoint to transcode/resize when needed.
• Include timezone with scheduled_date and keep ISO-8601 format to avoid timing mistakes.

Example use cases

• Simultaneously publish a campaign video to Instagram, TikTok, and YouTube with one POST to /upload_videos.
• Schedule a week of posts across LinkedIn, X, and Facebook with scheduled_date and manage jobs via schedule endpoints.
• Convert and optimize a raw clip using the FFmpeg endpoint before uploading to platform-specific endpoints.
• Upload a PDF pitch deck as a native LinkedIn document post for distribution to your company page.
• Fetch upload history and analytics to build a performance dashboard for a brand profile.