Bluesky API
Read Bluesky actor and post data from public AT Protocol endpoints.
bluesky
Data limits
- Keyword post search is held and unavailable.
- Engagement counters are request-time source snapshots; absent counters are omitted rather than reported as zero.
Capabilities
Every capability uses the same POST /execute envelope. Open an endpoint for
its exact ID, input contract, code samples, cost, runtime, and illustrative output.
Each endpoint lists its cost in credits per request; the
pricing page shows what credits cost.
bluesky.actor.get_followers
List followers for a Bluesky actor.
bluesky.actor.get_follows
List actors followed by a Bluesky actor.
bluesky.actor.get_profile
Fetch profile metadata for a Bluesky actor (handle, DID, or bsky.app profile link).
bluesky.actor.resolve_handle
Resolve a Bluesky handle to its DID.
bluesky.actor.search
Search actors by keyword with cursor pagination.
bluesky.feed.get_author_feed
Fetch an author's public feed of posts and reposts, with repost attribution and cursor pagination.
bluesky.feed.get_feed
Fetch posts from a specific feed URI with cursor pagination.
bluesky.feed.get_feed_generators
Discover popular feed sources used by the Bluesky app.
bluesky.feed.get_likes
List users who liked a post with cursor pagination.
bluesky.feed.get_post_thread
Fetch a post thread with bounded nested replies and source parent context (AT-URI or bsky.app post link).
bluesky.feed.get_reposted_by
List users who reposted a post with cursor pagination.
bluesky.feed.get_trending_topics
List trending topics surfaced by public feed index data.
Common uses
- Handle and profile verification
- Social graph snapshotting
- Author feed and follower analytics, including reposts
- Post engagement, embed and thread-context extraction
- Trending-topic and feed discovery
Integration contract
A 200 response completed inline. A 202 response was queued; poll
GET /jobs/:id until it reaches completed or failed.
- Authenticate REST requests
- Poll jobs and retrieve results
- Handle errors and safe retries
- Understand credits and limits
Use Bluesky data in Claude or connect another AI client with the MCP server.