Bluesky API: Posts, Threads & Link Cards

API id: bluesky

Bluesky is the easiest platform to connect: you don't need a platform app. In Channels → Accounts → Connect account, enter your Bluesky handle and an app password (you create one in your Bluesky settings — don't use your main password).

At a glance


Text	300 characters
Files per post	Up to 4 images, or 1 video
File needed?	No
Threads	Yes — up to 25 posts. Each reply can also have files.
Alt text	Yes
Edit after publish	No
Delete after publish	Yes
Analytics	Likes, comments, shares, quotes, saves
Comments	Read and reply

Files

Type	Rules
Images (JPEG, PNG, WebP)	Up to 4 per post, 2 MB each.
Video (MP4)	1 per post, on its own. Up to 10 minutes.

Options

Key	Type	What it does
`link_card`	true / false	Turns the first link in your text into a preview card. Bluesky never does this on its own. Only works on a post with no files and no quote.
`quote_post`	url	Quote another Bluesky post. Paste its link, like `https://bsky.app/profile/someone.bsky.social/post/3k2b…`.
`reply_control`	choice	Who can reply: `everybody` (default), `nobody`, `mentioned`, `following` or `followers`.
`self_label`	choice	Content warning for the media: `sexual`, `nudity`, `porn` or `graphic-media`.
`lang`	choice	Language of the post, like `en`, `fr` or `ja`. Only applies to the first post of a thread.

Example

{
  "channelId": "CHANNEL_BLUESKY",
  "options": { "link_card": "true" },
  "blocks": [{ "content": "We wrote about our new release: https://example.com/blog/v2" }]
}

Comments

You can read the replies to a published post and answer them. See Read and reply to comments.

Replies come back two levels deep in one page. There is no nextCursor.
Replies that were deleted, or that you can't see because of a block, are left out.
Your own thread posts are not listed.
Needs nothing extra: your app password already allows it.

Set up

Bluesky needs no developer app. You connect with an app password: see the Bluesky setup guide.

Bluesky