Bluesky API

Posting to Bluesky

JSON for a basic post with a link, hashtag, and image/video using the Bluesky API. Please see Bluesky Media Guidelines and Bluesky Authorization for more information.:

{
  "post": "The best Bluesky image post ever #best", // Max 300 characters or empty string
  "mediaUrls": ["https://img.acme.com/012/gb.jpg"],
  "platforms": ["bluesky"]
}

{
  "post": "The best Bluesky video post ever https://www.google.com", // Max 300 characters or empty string
  "mediaUrls": ["https://img.acme.com/012/vid.mp4"],
  "platforms": ["bluesky"]
}

Bluesky Supported Features

• Bluesky supports text, images (up to 4), video (only 1), and posts with links or emojis.
• Up to 4 images or one videos can be sent in a single post.
• The post text is limited to 300 characters.
• Animated GIFs are supported and sent as videos.
• Bluesky does support hashtags and mentions (@handle).
• Alt text on images or videos.
• See Bluesky Media Guidelines for more information.

• Link previews in posts are supported. Include a link in the post text and the ACME API will automatically add a link preview to the post.

Bluesky Unsupported Features

• Video thumbnails are not yet supported by Bluesky.

Bluesky Mentions

Mention another Bluesky handle by adding @handle in the post text. For example:

{
  "post": "The best Bluesky image post ever @handle",
  "platforms": ["bluesky"]
}

Alternative Text

Add Bluesky alternative text, also known as alt text, to an image or video. Bluesky alt text is an accessibility feature used for additional user info and screen readers.

Use the altText in the blueSkyOptions object.

{
  "blueSkyOptions": {
    // Array of Alt Texts
    "altText": ["This is my best pic", "😃 here is the next one"]
  }
}

Each alt text must correspond to an image or video in the mediaUrls array. The alt text will be applied to each media item in order.

Character Limits

Please see Bluesky Character Limits for more information.