Bluesky API

What you can post

Type	Supported	Max media	Notes
Text only	✅	0	Up to 300 characters
Image post	✅	4	JPEG, PNG, WebP. Max 2 MB per image
Video	✅	1	MP4 only. Max 100 MB, up to 3 minutes

Limitations

300 character limit. Emojis count as their UTF-8 byte length, not as 1 character. A single emoji like 🚀 uses 4 bytes, so heavy emoji use reduces your effective limit.
2 MB per image. Images larger than 2 MB will be rejected by Bluesky. Before April 23, 2026, the limit was 1 MB per image. PublishQ automatically prepares your images to fit these limits, doing its best to keep the quality as high as possible.
GIF files are not supported. Bluesky only displays the first frame of a GIF as a static image. Convert animated GIFs to MP4 and post as video instead.
You cannot mix images and video in the same post. A post is either up to 4 images or a single video.

Posting to Bluesky alongside other platforms

Bluesky has a 300-character limit, but platforms like Facebook or LinkedIn allow much longer content. You don't need to create a separate post — use postOverrides on the Bluesky account entry to provide shorter content just for Bluesky while keeping the full text for other platforms.

{
  "content": "Your long-form content for Facebook, LinkedIn, etc...",
  "accounts": [
    { "accountId": "facebook-account-id" },
    { "accountId": "linkedin-account-id" },
    {
      "accountId": "bluesky-account-id",
      "postOverrides": {
        "content": "Short version for Bluesky 🦋"
      }
    }
  ],
  "publishNow": true
}

Quick start

Post text

Mentions (@handle.bsky.social), links, and hashtags in your content are detected and rendered as rich text automatically. If you mention a handle that doesn't exist, it renders as plain text — no error.

curl -X POST https://publishq.com/api/v1/posts \
  -H "Authorization: Bearer pq_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Hello from PublishQ! Check out @bsky.app 🦋",
    "accounts": [
      { "accountId": "your-bluesky-account-id-on-publishq" }
    ],
    "publishNow": true
  }'

Post an image

Up to 4 images per post. Text is optional — you can post images with no caption.

Get your media ready

curl -X POST https://publishq.com/api/v1/media \
  -H "Authorization: Bearer pq_live_..." \
  -F "[email protected]"

Repeat for each file (up to 4 images).

curl https://publishq.com/api/v1/media \
  -H "Authorization: Bearer pq_live_..."

Pick the id of each media item you want to use from the response.

Create the post

curl -X POST https://publishq.com/api/v1/posts \
  -H "Authorization: Bearer pq_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Photo dump from the weekend 📸",
    "mediaIds": ["media-id-1", "media-id-2", "media-id-3", "media-id-4"],
    "accounts": [
      { "accountId": "your-bluesky-account-id-on-publishq" }
    ],
    "publishNow": true
  }'

Post a video

A single MP4 video per post. Text is optional. The video is preprocessed by Bluesky's video service before the post goes live, so there's no loading delay for your followers — the video is ready to play immediately.

Bluesky requires email verification on the connected account before video uploads.

Get your media ready

curl -X POST https://publishq.com/api/v1/media \
  -H "Authorization: Bearer pq_live_..." \
  -F "[email protected]"

curl https://publishq.com/api/v1/media \
  -H "Authorization: Bearer pq_live_..."

Pick the id of the video you want to use from the response.

Create the post

curl -X POST https://publishq.com/api/v1/posts \
  -H "Authorization: Bearer pq_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Check this out 🎬",
    "mediaIds": ["media-id-from-step-1"],
    "accounts": [
      { "accountId": "your-bluesky-account-id-on-publishq" }
    ],
    "publishNow": true
  }'

Media specs

Images

Spec	Value
Formats	JPEG, PNG, WebP
Max file size	2 MB per image
Max per post	4

Aspect ratios are detected automatically and embedded in the post record.

PublishQ prepares images for you

Upload any supported image and PublishQ fits it to these limits before publishing. It resizes high-resolution photos that exceed Bluesky's limits and compresses images larger than 2 MB, so you don't need to resize or shrink them yourself.

Video

Spec	Value
Format	MP4
Max file size	100 MB (increased from 50 MB)
Max duration	3 minutes (increased from 60 seconds)

Not yet supported

GIF attachments — Bluesky renders GIFs as static images. Convert to MP4 for animation.
Video captions — VTT subtitle files for accessibility.

On this page