# Bluesky User Posts API (https://www.socialcrawl.dev/platforms/bluesky/user-posts)

> Returns a feed of posts for a Bluesky user — uri, record text, author info, embeds, replyCount, repostCount, likeCount, quoteCount, and indexedAt. Pass either `handle` or `user_id` (Bluesky calls user IDs `did`).

TL;DR: `GET /v1/bluesky/user/posts` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `handle` | no | Bluesky handle. |
| `user_id` | no | Bluesky `did` (Bluesky's internal user ID format, e.g. `did:plc:x7d6j54pm22ufehkes6jo4jf`). |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/bluesky/user/posts" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I list a Bluesky user's posts with an API?

Send a GET request to /v1/bluesky/user/posts with either a handle (espn.com) or a user_id — Bluesky's DID format, like did:plc:x7d6j54pm22ufehkes6jo4jf. SocialCrawl returns the user's post feed with text, embeds, and engagement counts in one JSON response.

### What fields does the Bluesky User Posts API return?

Each post includes its uri, record text, author info, embeds (images, links, quoted posts), replyCount, repostCount, likeCount, quoteCount, and indexedAt timestamp — normalized into the unified PostList schema shared across SocialCrawl platforms.

### Can I pass a DID instead of a handle?

Yes. The endpoint accepts either handle or user_id. Use the DID (did:plc:...) when you track accounts long-term — DIDs are permanent identifiers that survive handle changes, so your pipeline won't break when a user renames.

### How much does the Bluesky User Posts API cost?

Each request costs 1 credit on the standard tier. New accounts get 100 free credits with no credit card required — enough to pull 100 post feeds while you validate the response shape.

### Can I use this for brand monitoring or research on Bluesky?

Yes. The feed returns engagement counts per post, so you can rank a brand account's content by likes or reposts, archive academic research samples, or feed social listening dashboards — without running an AT Protocol firehose consumer.

See the full Bluesky API: https://www.socialcrawl.dev/platforms/bluesky

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to list a Bluesky user's posts with the SocialCrawl API
- What does the SocialCrawl Bluesky User Posts API return?