# Bluesky API

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

- Platform ID: `bluesky`
- Capabilities: 12
- Execute endpoint: `POST https://data.upscrape.com/execute`


## 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

### [Get followers](https://docs.upscrape.com/docs/platforms/bluesky/bluesky.actor.get_followers)

- Capability ID: `bluesky.actor.get_followers`
- Cost: 1 credit per request

List followers for a Bluesky actor.
### [Get follows](https://docs.upscrape.com/docs/platforms/bluesky/bluesky.actor.get_follows)

- Capability ID: `bluesky.actor.get_follows`
- Cost: 1 credit per request

List actors followed by a Bluesky actor.
### [Get profile](https://docs.upscrape.com/docs/platforms/bluesky/bluesky.actor.get_profile)

- Capability ID: `bluesky.actor.get_profile`
- Cost: 1 credit per request

Fetch profile metadata for a Bluesky actor (handle, DID, or bsky.app profile link).
### [Resolve handle](https://docs.upscrape.com/docs/platforms/bluesky/bluesky.actor.resolve_handle)

- Capability ID: `bluesky.actor.resolve_handle`
- Cost: 1 credit per request

Resolve a Bluesky handle to its DID.
### [Search actors](https://docs.upscrape.com/docs/platforms/bluesky/bluesky.actor.search)

- Capability ID: `bluesky.actor.search`
- Cost: 1 credit per request

Search actors by keyword with cursor pagination.
### [Get author feed](https://docs.upscrape.com/docs/platforms/bluesky/bluesky.feed.get_author_feed)

- Capability ID: `bluesky.feed.get_author_feed`
- Cost: 1 credit per request

Fetch an author's public feed of posts and reposts, with repost attribution and cursor pagination.
### [Get feed posts](https://docs.upscrape.com/docs/platforms/bluesky/bluesky.feed.get_feed)

- Capability ID: `bluesky.feed.get_feed`
- Cost: 1 credit per request

Fetch posts from a specific feed URI with cursor pagination.
### [Get feed generators](https://docs.upscrape.com/docs/platforms/bluesky/bluesky.feed.get_feed_generators)

- Capability ID: `bluesky.feed.get_feed_generators`
- Cost: 1 credit per request

Discover popular feed sources used by the Bluesky app.
### [Get post likes](https://docs.upscrape.com/docs/platforms/bluesky/bluesky.feed.get_likes)

- Capability ID: `bluesky.feed.get_likes`
- Cost: 1 credit per request

List users who liked a post with cursor pagination.
### [Get post thread](https://docs.upscrape.com/docs/platforms/bluesky/bluesky.feed.get_post_thread)

- Capability ID: `bluesky.feed.get_post_thread`
- Cost: 1 credit per request

Fetch a post thread with bounded nested replies and source parent context (AT-URI or bsky.app post link).
### [Get repost users](https://docs.upscrape.com/docs/platforms/bluesky/bluesky.feed.get_reposted_by)

- Capability ID: `bluesky.feed.get_reposted_by`
- Cost: 1 credit per request

List users who reposted a post with cursor pagination.
### [Get trending topics](https://docs.upscrape.com/docs/platforms/bluesky/bluesky.feed.get_trending_topics)

- Capability ID: `bluesky.feed.get_trending_topics`
- Cost: 1 credit per request

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

All capabilities use the shared `POST /execute` envelope. A `200` response completed inline; a `202` response must be polled through `GET /jobs/{id}`.

See [authentication](https://docs.upscrape.com/docs/api/authentication), [jobs and results](https://docs.upscrape.com/docs/api/jobs), and [errors and retries](https://docs.upscrape.com/docs/api/errors).