postfastSchedule and manage social media posts across TikTok, Instagram, Facebook, X (Twitter), YouTube, LinkedIn, Threads, Bluesky, and Pinterest using the PostFast API. Use when the user wants to schedule social media posts, manage social media content, upload media for social posting, list connected social accounts, check scheduled posts, delete scheduled posts, cross-post content to multiple platforms, or automate their social media workflow. PostFast is a SaaS tool ā no self-hosting required.
Install via ClawdBot CLI:
clawdbot install peturgeorgievv/postfastSchedule social media posts across 9 platforms from one API. SaaS ā no self-hosting needed.
export POSTFAST_API_KEY="your-api-key"Base URL: https://api.postfa.st
Auth header: pf-api-key: $POSTFAST_API_KEY
curl -s -H "pf-api-key: $POSTFAST_API_KEY" https://api.postfa.st/social-media/my-social-accountsReturns array of { id, platform, platformUsername, displayName }. Save the id ā it's the socialMediaId for posting.
curl -X POST https://api.postfa.st/social-posts \
-H "pf-api-key: $POSTFAST_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"posts": [{
"content": "Your post text here",
"mediaItems": [],
"scheduledAt": "2025-06-15T10:00:00.000Z",
"socialMediaId": "ACCOUNT_ID_HERE"
}],
"controls": {}
}'Step A ā Get signed upload URLs:
curl -X POST https://api.postfa.st/file/get-signed-upload-urls \
-H "pf-api-key: $POSTFAST_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "contentType": "image/png", "count": 1 }'Returns [{ "key": "image/uuid.png", "signedUrl": "https://..." }].
Step B ā Upload file to S3:
curl -X PUT "SIGNED_URL_HERE" \
-H "Content-Type: image/png" \
--data-binary @/path/to/file.pngStep C ā Create post with media key:
curl -X POST https://api.postfa.st/social-posts \
-H "pf-api-key: $POSTFAST_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"posts": [{
"content": "Post with image!",
"mediaItems": [{ "key": "image/uuid.png", "type": "IMAGE", "sortOrder": 0 }],
"scheduledAt": "2025-06-15T10:00:00.000Z",
"socialMediaId": "ACCOUNT_ID_HERE"
}],
"controls": {}
}'For video: use contentType: "video/mp4", type: "VIDEO", key prefix video/.
curl -s -H "pf-api-key: $POSTFAST_API_KEY" https://api.postfa.st/social-postscurl -X DELETE -H "pf-api-key: $POSTFAST_API_KEY" https://api.postfa.st/social-posts/POST_IDInclude multiple entries in the posts array, each with a different socialMediaId. They share the same controls and mediaItems keys.
Pass these in the controls object. See references/platform-controls.md for full details.
| Platform | Key Controls |
|---|---|
| TikTok | tiktokPrivacy, tiktokAllowComments, tiktokAllowDuet, tiktokAllowStitch, tiktokIsDraft, tiktokBrandContent, tiktokAutoAddMusic |
| Instagram | instagramPublishType (TIMELINE/STORY/REEL), instagramPostToGrid, instagramCollaborators |
| Facebook | facebookContentType (POST/REEL/STORY) |
| YouTube | youtubeIsShort, youtubeTitle, youtubePrivacy, youtubePlaylistId, youtubeTags, youtubeMadeForKids |
| LinkedIn | linkedinAttachmentKey, linkedinAttachmentTitle (for document posts) |
| X (Twitter) | xQuoteTweetUrl (for quote tweets) |
| Pinterest | pinterestBoardId (required), pinterestLink |
| Bluesky | No platform-specific controls ā text + images only |
| Threads | No platform-specific controls ā text + images/video |
GET /social-media/{id}/pinterest-boards ā returns [{ boardId, name }]GET /social-media/{id}/youtube-playlists ā returns [{ playlistId, title }]X-RateLimit-Remaining-* headersRetry-After-* header| Platform | Images | Video | Carousel |
|---|---|---|---|
| TikTok | Carousels only | ā¤250MB, MP4/MOV, 3s-10min | 2-35 images |
| Instagram | JPEG/PNG | ā¤1GB, 3-90s (Reels) | Up to 10 |
| Facebook | ā¤30MB, JPG/PNG | 1 per post | Up to 10 images |
| YouTube | ā | Shorts ā¤3min, H.264 | ā |
| LinkedIn | Up to 9 | ā¤10min | Up to 9, or documents (PDF/PPTX/DOCX) |
| X (Twitter) | Up to 4 | ā | ā |
| Pinterest | 2:3 ratio ideal | Supported | 2-5 images |
| Bluesky | Up to 4 | Not supported | ā |
| Threads | Supported | Supported | Up to 10 |
my-social-accounts first to get valid socialMediaId values.scheduledAt must be ISO 8601 UTC and in the future.pinterestBoardId ā fetch boards first.linkedinAttachmentKey instead of mediaItems.mediaItems with sequential sortOrder.coverTimestamp (seconds) in mediaItems.Generated Mar 1, 2026
A social media manager schedules weekly content across Instagram, Facebook, and LinkedIn for multiple small business clients. They use PostFast to batch-create posts, upload images, and set future publishing times, streamlining their workflow and ensuring consistent brand presence without manual posting.
A digital creator produces videos and images for TikTok, YouTube Shorts, and Instagram Reels. They leverage PostFast to cross-post content simultaneously, manage platform-specific controls like YouTube titles or TikTok privacy settings, and schedule releases during peak engagement hours to maximize reach.
An e-commerce company launches a new product and uses PostFast to schedule promotional posts across Pinterest, X (Twitter), and Facebook. They upload product images, set up carousels, and coordinate a timed campaign with Pinterest board integration and Facebook content types to drive traffic to their website.
A non-profit organization runs an awareness campaign across LinkedIn, Threads, and Bluesky. They schedule text-based updates and infographics, use LinkedIn for document attachments like PDF reports, and automate posting to maintain engagement without dedicating staff time to manual social media management.
A marketing agency handles social media for diverse clients in industries like hospitality and tech. They use PostFast to list connected accounts, schedule posts with media for each client, and delete or adjust scheduled content based on real-time feedback, ensuring compliance with platform-specific controls and rate limits.
PostFast operates as a Software-as-a-Service (SaaS) tool, generating revenue through monthly or annual subscription plans. Users pay based on features like the number of social accounts, post volume, or advanced analytics, with tiered pricing catering to individuals, small businesses, and enterprises.
The business model includes API usage tiers where revenue scales with API call volume or data throughput. Higher-tier plans offer increased rate limits, priority support, and access to premium features like advanced scheduling or cross-platform analytics, appealing to heavy users and agencies.
PostFast offers white-label or reseller options for marketing agencies, allowing them to brand the tool as their own and manage multiple client accounts seamlessly. This generates revenue through licensing fees or revenue-sharing agreements, expanding market reach without direct customer acquisition costs.
š¬ Integration Tip
Always fetch connected accounts first to obtain valid socialMediaId values, and for media posts, follow the three-step upload flow (signed URL, S3 PUT, create post) to ensure proper handling across platforms.
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.