Bluesky API Guide

How to Schedule Bluesky Posts via API

Publish text posts and images to Bluesky using the PostFast API. Schedule content to the decentralized social network programmatically.

Last updated: January 2025
Automate your Bluesky content strategyGet API Key

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 and images.

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 4 images), 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/d4e5f6g7-h8i9-0123-4567-890123defghi.jpg",
                        "type": "IMAGE",
                        "sortOrder": 0
                    }
                ],
                "scheduledAt": "2025-01-31T14:00:00.000Z",
                "socialMediaId": "cc2k4055-m9gi-08k1-h483-112322116008"
            }
        ],
        "controls": {}
    })
});

const data = await response.json();

Did You Know?

Character Limit
300 characters
Bluesky posts are limited to 300 characters, similar to original Twitter
Images
Up to 4 images
You can attach up to 4 images per post
Video
Not yet supported
Bluesky does not currently support video uploads via API
Link Previews
Automatic
URLs automatically generate link cards with preview images

Tips

Keep posts concise - the 300 character limit encourages brevity

Use threads for longer content by scheduling multiple connected posts

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

✓ 7-day free trial
Try PostFast Free

Common Pitfalls

Character count surprises

URLs and mentions count toward the 300 character limit. Long URLs can quickly consume your available space.

No video support

Unlike X or Threads, Bluesky does not support video uploads via API. Plan image-only media strategies.

No edit feature

Bluesky does not support editing posts after publishing. Proofread carefully before scheduling.

Frequently Asked Questions

Does Bluesky support video?

Not via API currently. Bluesky is still developing video support. For now, stick to text and images when scheduling via the PostFast API.

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.

Build your Bluesky presence with programmatic posting

Start Free Trial
✓ 7-day free trial✓ Cancel anytime