# Bluesky API — UnifAPI

> Profiles, posts, replies. Read public Bluesky profiles with follower counts, a profile's posts with like, repost and reply counts, and single posts with their replies.

- Category: Social platforms
- API base URL: https://api.unifapi.com
- Auth: `Authorization: Bearer <UnifAPI API key>` (OAuth recommended for MCP clients)
- MCP server: https://mcp.unifapi.com
- Developer docs: https://docs.unifapi.com/api/bluesky
- OpenAPI spec: https://unifapi.com/openapi.json
- HTML page: https://unifapi.com/apis/bluesky
- Full catalog: https://unifapi.com/apis.md

## Agent workflows

- Follow what journalists, researchers and brands post on Bluesky next to their X and Threads activity.
- Measure engagement on the open social web from each post's like, repost, reply and quote counts.
- Turn a Bluesky handle or post link into a normalized record an agent can cite in a social listening brief.

## Endpoints (3)

Every endpoint returns the UnifAPI JSON envelope (`request_id`, `data`, `pagination` on lists, `billing`) and bills max(records × credits per record, minimum) in credits.

### Get a Bluesky profile

`GET /bluesky/users/{username}`

Returns a public Bluesky profile by handle: display name, bio, avatar, follower, following and post counts. Returns `not_found` when the handle does not exist.

- Price: 1 credit per record, minimum 3 credits ($0.003) per call
- Required: `username` (path)
- Details: https://unifapi.com/apis/bluesky/users/username/get
- Docs: https://docs.unifapi.com/api/bluesky/users/username/get

### List posts from a Bluesky profile

`GET /bluesky/users/{username}/posts`

Returns recent posts from a public Bluesky profile, newest first, with text, embeds and like, repost and reply counts. Paginate with `cursor`.

- Price: 1 credit per record, minimum 3 credits ($0.003) per call
- Required: `username` (path)
- Details: https://unifapi.com/apis/bluesky/users/username/posts/get
- Docs: https://docs.unifapi.com/api/bluesky/users/username/posts/get

### Get a Bluesky post

`GET /bluesky/users/{username}/posts/{id}`

Returns one Bluesky post by author handle and post id (the record key at the end of a bsky.app post link), with replies. Returns `not_found` when the post does not exist.

- Price: 1 credit per record, minimum 3 credits ($0.003) per call
- Required: `username` (path), `id` (path)
- Details: https://unifapi.com/apis/bluesky/users/username/posts/id/get
- Docs: https://docs.unifapi.com/api/bluesky/users/username/posts/id/get

## Related APIs

- [Pinterest API](https://unifapi.com/apis/pinterest/index.md) — Pins, boards, search
- [Facebook API](https://unifapi.com/apis/facebook/index.md) — Pages, posts, reels, groups, events, Marketplace, Ad Library
- [Snapchat API](https://unifapi.com/apis/snapchat/index.md) — Public profiles, Spotlight videos, comments
- [Reddit API](https://unifapi.com/apis/reddit/index.md) — Subreddits, posts, comments, feeds, search
- [Telegram API](https://unifapi.com/apis/telegram/index.md) — Public channels, posts, reactions
- [Threads API](https://unifapi.com/apis/threads/index.md) — Posts, replies, reposts, search