Bluesky API

​

Posting to Bluesky

Posting to Bluesky via the API requires connecting a Bluesky account.

JSON for a basic post with a link, hashtag, and image/video to a Bluesky account:

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

​

Bluesky Supported Features

• Bluesky supports text, image (4), video (1), and posts with links or emojis.
• 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 Ayrshare 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 applies to each media item in order.