Skip to documentation
Browse documentation

Bluesky API

Read Bluesky actor and post data from public AT Protocol endpoints.

Platform ID bluesky
Endpoints 12 capabilities
View raw

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.

Get followers bluesky.actor.get_followers

List followers for a Bluesky actor.

From $1.25 per 1,000 requests · 1 credit
Get follows bluesky.actor.get_follows

List actors followed by a Bluesky actor.

From $1.25 per 1,000 requests · 1 credit
Get profile bluesky.actor.get_profile

Fetch profile metadata for a Bluesky actor (handle, DID, or bsky.app profile link).

From $1.25 per 1,000 requests · 1 credit
Resolve handle bluesky.actor.resolve_handle

Resolve a Bluesky handle to its DID.

From $1.25 per 1,000 requests · 1 credit
Search actors bluesky.actor.search

Search actors by keyword with cursor pagination.

From $1.25 per 1,000 requests · 1 credit
Get author feed bluesky.feed.get_author_feed

Fetch an author's public feed of posts and reposts, with repost attribution and cursor pagination.

From $1.25 per 1,000 requests · 1 credit
Get feed posts bluesky.feed.get_feed

Fetch posts from a specific feed URI with cursor pagination.

From $1.25 per 1,000 requests · 1 credit
Get feed generators bluesky.feed.get_feed_generators

Discover popular feed sources used by the Bluesky app.

From $1.25 per 1,000 requests · 1 credit
Get post likes bluesky.feed.get_likes

List users who liked a post with cursor pagination.

From $1.25 per 1,000 requests · 1 credit
Get post thread bluesky.feed.get_post_thread

Fetch a post thread with bounded nested replies and source parent context (AT-URI or bsky.app post link).

From $1.25 per 1,000 requests · 1 credit
Get repost users bluesky.feed.get_reposted_by

List users who reposted a post with cursor pagination.

From $1.25 per 1,000 requests · 1 credit
Get trending topics bluesky.feed.get_trending_topics

List trending topics surfaced by public feed index data.

From $1.25 per 1,000 requests · 1 credit

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.

Use Bluesky data in Claude or connect another AI client with the MCP server.