upload-postUpload content to social media platforms via Upload-Post API. Use when posting videos, photos, text, or documents to TikTok, Instagram, YouTube, LinkedIn, Facebook, X (Twitter), Threads, Pinterest, Reddit, or Bluesky. Supports scheduling, analytics, FFmpeg processing, and upload history.
Install via ClawdBot CLI:
clawdbot install victorcavero14/upload-postPost content to multiple social media platforms with a single API call.
user parameter in API callsAuthorization: Apikey YOUR_API_KEYBase URL: https://api.upload-post.com/api
The user parameter in all endpoints refers to your profile name (not username), which determines which connected social accounts receive the content.
| Endpoint | Method | Description |
|----------|--------|-------------|
| /upload_videos | POST | Upload videos |
| /upload_photos | POST | Upload photos/carousels |
| /upload_text | POST | Text-only posts |
| /upload_document | POST | Upload documents (LinkedIn only) |
| /uploadposts/status?request_id=X | GET | Check async upload status |
| /uploadposts/history | GET | Upload history |
| /uploadposts/schedule | GET | List scheduled posts |
| /uploadposts/schedule/ | DELETE | Cancel scheduled post |
| /uploadposts/schedule/ | PATCH | Edit scheduled post |
| /uploadposts/me | GET | Validate API key |
| /analytics/ | GET | Get analytics |
| /uploadposts/facebook/pages | GET | List Facebook pages |
| /uploadposts/linkedin/pages | GET | List LinkedIn pages |
| /uploadposts/pinterest/boards | GET | List Pinterest boards |
| /uploadposts/reddit/detailed-posts | GET | Get Reddit posts with media |
| /ffmpeg | POST | Process media with FFmpeg |
curl -X POST "https://api.upload-post.com/api/upload_videos" \
-H "Authorization: Apikey YOUR_KEY" \
-F "user=profile_name" \
-F "platform[]=instagram" \
-F "platform[]=tiktok" \
-F "video=@video.mp4" \
-F "title=My caption"Key parameters:
user: Profile username (required)platform[]: Target platforms (required)video: Video file or URL (required)title: Caption/title (required)description: Extended descriptionscheduled_date: ISO-8601 date for schedulingtimezone: IANA timezone (e.g., "Europe/Madrid")async_upload: Set true for background processingfirst_comment: Auto-post first commentcurl -X POST "https://api.upload-post.com/api/upload_photos" \
-H "Authorization: Apikey YOUR_KEY" \
-F "user=profile_name" \
-F "platform[]=instagram" \
-F "photos[]=@photo1.jpg" \
-F "photos[]=@photo2.jpg" \
-F "title=My caption"Instagram & Threads support mixed carousels (photos + videos in same post).
curl -X POST "https://api.upload-post.com/api/upload_text" \
-H "Authorization: Apikey YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"user": "profile_name",
"platform": ["x", "threads", "bluesky"],
"title": "My text post"
}'Supported: X, LinkedIn, Facebook, Threads, Reddit, Bluesky.
Upload PDFs, PPTs, DOCs as native LinkedIn document posts (carousel viewer).
curl -X POST "https://api.upload-post.com/api/upload_document" \
-H "Authorization: Apikey YOUR_KEY" \
-F "user=profile_name" \
-F 'platform[]=linkedin' \
-F "document=@presentation.pdf" \
-F "title=Document Title" \
-F "description=Post text above document"Parameters:
document: PDF, PPT, PPTX, DOC, DOCX (max 100MB, 300 pages)title: Document title (required)description: Post commentaryvisibility: PUBLIC, CONNECTIONS, LOGGED_IN, CONTAINERtarget_linkedin_page_id: Post to company page| Platform | Videos | Photos | Text | Documents |
|----------|--------|--------|------|-----------|
| TikTok | ✓ | ✓ | - | - |
| Instagram | ✓ | ✓ | - | - |
| YouTube | ✓ | - | - | - |
| LinkedIn | ✓ | ✓ | ✓ | ✓ |
| Facebook | ✓ | ✓ | ✓ | - |
| X (Twitter) | ✓ | ✓ | ✓ | - |
| Threads | ✓ | ✓ | ✓ | - |
| Pinterest | ✓ | ✓ | - | - |
| Reddit | - | ✓ | ✓ | - |
| Bluesky | ✓ | ✓ | ✓ | - |
curl "https://api.upload-post.com/api/uploadposts/history?page=1&limit=20" \
-H "Authorization: Apikey YOUR_KEY"Parameters:
page: Page number (default: 1)limit: 10, 20, 50, or 100 (default: 10)Returns: upload timestamp, platform, success status, post URLs, errors.
Add scheduled_date parameter (ISO-8601):
{
"scheduled_date": "2026-02-01T10:00:00Z",
"timezone": "Europe/Madrid"
}Response includes job_id. Manage with:
GET /uploadposts/schedule - List all scheduledDELETE /uploadposts/schedule/ - CancelPATCH /uploadposts/schedule/ - Edit (date, title, caption)For async uploads or scheduled posts:
curl "https://api.upload-post.com/api/uploadposts/status?request_id=XXX" \
-H "Authorization: Apikey YOUR_KEY"Or use job_id for scheduled posts.
curl "https://api.upload-post.com/api/analytics/profile_name?platforms=instagram,tiktok" \
-H "Authorization: Apikey YOUR_KEY"Supported: Instagram, TikTok, LinkedIn, Facebook, X, YouTube, Threads, Pinterest, Reddit, Bluesky.
Returns: followers, impressions, reach, profile views, time-series data.
# Facebook Pages
curl "https://api.upload-post.com/api/uploadposts/facebook/pages" \
-H "Authorization: Apikey YOUR_KEY"
# LinkedIn Pages
curl "https://api.upload-post.com/api/uploadposts/linkedin/pages" \
-H "Authorization: Apikey YOUR_KEY"
# Pinterest Boards
curl "https://api.upload-post.com/api/uploadposts/pinterest/boards" \
-H "Authorization: Apikey YOUR_KEY"Get posts with full media info (images, galleries, videos):
curl "https://api.upload-post.com/api/uploadposts/reddit/detailed-posts?profile_username=myprofile" \
-H "Authorization: Apikey YOUR_KEY"Returns up to 2000 posts with media URLs, dimensions, thumbnails.
Process media with custom FFmpeg commands:
curl -X POST "https://api.upload-post.com/api/ffmpeg" \
-H "Authorization: Apikey YOUR_KEY" \
-F "file=@input.mp4" \
-F "full_command=ffmpeg -y -i {input} -c:v libx264 -crf 23 {output}" \
-F "output_extension=mp4"{input} and {output} placeholdersFINISHED/ffmpeg/job//download {input0}, {input1}, etc.Quotas: Free 30min/mo, Basic 300min, Pro 1000min, Advanced 3000min, Business 10000min.
See references/platforms.md for detailed platform parameters.
See references/requirements.md for format specs per platform.
| Code | Meaning |
|------|---------|
| 400 | Bad request / missing params |
| 401 | Invalid API key |
| 404 | Resource not found |
| 429 | Rate limit / quota exceeded |
| 500 | Server error |
x_long_text_as_post=trueGenerated Mar 1, 2026
A social media manager uses the skill to schedule and post multimedia content across multiple platforms like Instagram, TikTok, and LinkedIn for a brand's marketing campaigns. They leverage analytics to track performance and adjust strategies, ensuring consistent engagement and reach.
An influencer or content creator uploads videos and photos to platforms such as YouTube, Facebook, and Pinterest to build their personal brand. They use scheduling features to maintain a regular posting schedule and analyze audience metrics to optimize content for growth.
An e-commerce store uses the skill to post product photos and videos to social media platforms like Instagram and Pinterest to drive sales. They schedule posts around peak shopping times and use analytics to measure campaign effectiveness and customer engagement.
A company's communications team posts text updates, documents, and videos to LinkedIn and Facebook to share news, reports, and announcements. They utilize document uploads for LinkedIn to distribute presentations and reports, enhancing professional outreach.
An event organizer uploads photos and videos from events to platforms like X, Threads, and Reddit in real-time to promote activities and engage attendees. They schedule pre-event content and use analytics to gauge interest and adjust promotional strategies.
Offer the skill as part of a subscription-based service where users pay monthly or annually for access to multi-platform posting, scheduling, and analytics. Revenue is generated through tiered pricing plans based on usage limits and advanced features like FFmpeg processing.
A marketing agency integrates the skill into their service offerings to manage social media for clients, charging a retainer or project-based fee. Revenue comes from service packages that include content creation, scheduling, and performance reporting using the skill's analytics.
Freelancers use the skill to streamline their workflow for multiple clients, offering it as an add-on service or charging per post. Revenue is generated through hourly rates or bundled packages that include social media management and analytics insights.
💬 Integration Tip
Start by setting up a profile and connecting accounts, then use simple endpoints like upload_text for text posts to test before moving to media uploads with scheduling.
Fetch and read transcripts from YouTube videos. Use when you need to summarize a video, answer questions about its content, or extract information from it.
Fetch and summarize YouTube video transcripts. Use when asked to summarize, transcribe, or extract content from YouTube videos. Handles transcript fetching via residential IP proxy to bypass YouTube's cloud IP blocks.
Browse, search, post, and moderate Reddit. Read-only works without auth; posting/moderation requires OAuth setup.
Interact with Twitter/X — read tweets, search, post, like, retweet, and manage your timeline.
LinkedIn automation via browser relay or cookies for messaging, profile viewing, and network actions.
Search YouTube videos, get channel info, fetch video details and transcripts using YouTube Data API v3 via MCP server or yt-dlp fallback.