What it returns
Posts by handle (text, timestamps, likes, reposts, replies, quotes, images, links, hashtags), profiles (followers, follows, post count) and user search from Bluesky's official public AT Protocol API. No login needed.
Modes: posts, profiles, searchUsers, searchPosts. Charged per row returned.
Request
POST https://api.pushbuild.com/bluesky-scraper/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
mode | string: posts, profiles, searchUsers, searchPosts | What to fetch. Default: "posts". |
handles | list of strings | Bluesky handles or DIDs, e.g. bsky.app, nytimes.com (posts and profiles modes). |
query | string | Text to search for (search modes). |
since | string | ISO date or time; posts older than this are skipped, e.g. 2026-10-01. |
includeReplies | boolean | Posts mode: include the author's replies. Default: false. |
includeReposts | boolean | Posts mode: include posts the author reposted. Default: false. |
sort | string: latest, top | Search posts mode. Default: "latest". |
lang | string | Search posts mode: two-letter language code, e.g. en. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/bluesky-scraper/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.32 per 1,000 rows. No charge for errors or empty searches.
Use it from Claude, ChatGPT or Cursor
This API is also an MCP server: https://api.pushbuild.com/mcp/bluesky-scraper. Add it to any assistant that supports remote MCP servers, with your key in the X-API-Key header. Same prices. Setup for each app.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.comNeed data from a site with no API? Web scraping and data pipelines