How to Schedule Bluesky Posts via API
Publish text posts, images and video to Bluesky using the PostFast API. Schedule content to the decentralized social network programmatically.
Bluesky is a decentralized social network built on the AT Protocol, offering an alternative to X (Twitter) with a focus on user control and open standards. Using the PostFast API, you can schedule posts to Bluesky including text, images and video.
Bluesky has a 300-character limit per post (similar to old Twitter) and supports images with alt text. The platform is growing rapidly as users seek alternatives to traditional social networks.
Key capabilities when scheduling Bluesky posts via API include text posts (up to 300 characters), image posts (up to 10 images), video posts (1 MP4 video), link cards (automatic URL previews), and mentions and hashtags.
Code Example
const response = await fetch('https://api.postfa.st/social-posts', {
method: 'POST',
headers: {
'pf-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"posts": [
{
"content": "Just discovered PostFast for scheduling posts across platforms. Game changer for content creators! 🦋\n\nAnyone else automating their social presence?",
"mediaItems": [
{
"key": "image/d4e5f6a7-b8c9-0123-4567-890123abcdef.jpg",
"type": "IMAGE",
"sortOrder": 0
}
],
"scheduledAt": "2025-01-31T14:00:00.000Z",
"socialMediaId": "cc2a4055-a9ab-08c1-b483-112322116008"
}
],
"controls": {}
})
});
const data = await response.json();
Did You Know?
Tips
Keep posts concise - the 300 character limit encourages brevity
For longer content, write separate posts: PostFast does not link them into a Bluesky thread yet
Include alt text for images to improve accessibility
Engage with the community - Bluesky users value authentic interaction
Schedule to Bluesky, X, Threads, and more from one API
Common Pitfalls
URLs and mentions count toward the 300 character limit. Long URLs can quickly consume your available space.
Bluesky accepts video only from accounts with a verified email address. Verify it in Bluesky under Settings > Account > Email before scheduling video. Text and image posts are unaffected.
Bluesky does not support editing posts after publishing. Proofread carefully before scheduling.
Frequently Asked Questions
Does Bluesky support video?
Yes. Attach one MP4 video of up to 100 MB as a VIDEO media item. A post carries a video or images, never both, and the Bluesky account needs a verified email address before it can post video.
How do hashtags work on Bluesky?
Hashtags work similarly to other platforms. Include them in your post text and they become clickable/searchable. Bluesky is still developing robust hashtag discovery features.
Can I schedule threads on Bluesky?
You can schedule multiple posts with the same scheduledAt time to create a thread effect. Full thread support with proper linking is on our roadmap.