Bluesky Scraper API: Posts, Profiles & Threads
The Bluesky Scraper API reads the public AT Protocol and returns six kinds of result: posts found by keyword or hashtag, an author's recent posts, a whole thread with nested replies, profile metadata, follower lists and following lists. Post rows carry author handle, text, createdAt, likeCount, repostCount, replyCount, hashtags, langs and a bsky.app URL. Posts cost $1.00 per 1,000 and profiles $2.00 per 1,000, with no login. Run it from Apify Console or the API.
from $0.001 per post scraped, $1.00 per 1,000 · Updated Nov 2026, version 0.2.13
Key facts
- Price
- from $0.001 per post scraped, $1.00 per 1,000
- Pricing model
- Pay per event
- Output
- JSON, CSV, Excel, XML, RSS via Apify datasets
- Access
- Apify Console, REST API, Python and JS clients, MCP tool bluesky
- Version
- Updated Nov 2026, version 0.2.13
- Usage
- 100.0% successful runs (30 days)
- Actor
subimpact/bluesky-scraper-api
Who it is for
- Social teams tracking brand mentions and hashtags on Bluesky
- Researchers studying conversation threads and reply structure
- Growth analysts mapping follower graphs in a niche
- Developers building a Bluesky dataset without managing credentials
Use cases
Track a hashtag or keyword
Set mode to search, put your phrase or tag in query such as artificial intelligence or #buildinpublic, and choose sort latest or top. Each row carries likeCount, repostCount, replyCount and quoteCount, so top sorting reveals what engaged, while latest sorting gives a monitoring feed with createdAt for timing.
Pull an account's recent posts
Use mode author_feed with handle set to bsky.app or jay.bsky.team. You get that account's posts with text, hashtags and langs, plus authorDid and authorDisplayName. Because handles and DIDs are both accepted, a handle change does not break the input, and hasEmbed flags posts carrying media or quoted embeds.
Rebuild a full conversation
Set mode thread, pass postUri as an at:// URI or a bsky.app post URL and turn includeReplies on. The actor walks nested replies, so each row is a post with its own metrics and a url back to the web. That gives a dataset of a debate's shape rather than just the opening post, ready for reply tree analysis.
Map a follower graph
Run mode followers or follows with a handle to list the accounts on either side of the relationship, then read handle, displayName, description and followersCount per row. Profiles and graph edges are priced at $2.00 per 1,000 and posts at $1.00 per 1,000, so a graph crawl is metered separately from post collection.
Get profile context for a set of authors
Mode profile returns description, avatar, banner, followersCount, followsCount, postsCount and indexedAt for one handle. Pair it with the authorHandle values from a search run to attach bios and reach to each post, which is how you tell whether a trend is driven by established accounts or by new ones.
Output fields
| Field | Type | Description |
|---|---|---|
uri | string | AT-Protocol URI of the post |
cid | string | Content identifier hash |
authorHandle | string/null | Author handle (e.g. user.bsky.social) |
authorDid | string/null | Author decentralized identifier (DID) |
authorDisplayName | string/null | Author visible display name |
text | string | Post text content |
createdAt | string/null | ISO timestamp of creation |
likeCount | integer/null | Total likes |
repostCount | integer/null | Total reposts |
replyCount | integer/null | Total replies |
quoteCount | integer/null | Total quotes |
langs | array | Languages tagged in the post |
Show all 26 fields
| Field | Type | Description |
|---|---|---|
hashtags | array | Hashtags mentioned in post |
hasEmbed | boolean | Whether the post includes media or quoted embeds |
url | string/null | Direct bsky.app post URL |
did | string/null | Account decentralized identifier |
handle | string/null | Account handle |
displayName | string/null | Account display name |
description | string/null | Account biography |
avatar | string/null | Avatar image link |
banner | string/null | Banner image link |
followersCount | integer/null | Total follower count |
followsCount | integer/null | Total following count |
postsCount | integer/null | Total posts published by author |
indexedAt | string/null | Timestamp when profile was indexed |
mode | string | Scrape mode that generated this row |
Sample output
From one of our own test runs on 20 Nov 2026, trimmed. Personal data is redacted.
2 rows, first 3 shown
[
{
"uri": "at://did:plc:nvy4upszpuyvjjtn3flhmwva/app.bsky.feed.post/3n2pk3qabsc2m",
"cid": "bafyreickariwoahqsngtc7ulzzfchawt776thfz5czkwsfsjjqr3tfl6va",
"authorHandle": "mrg9999.bsky.social",
"authorDid": "did:plc:nvy4upszpuyvjjtn3flhmwva",
"authorDisplayName": "Mr.G",
"text": "Horizon Android open source navigation app \ngithub.com/benbishop028...\n\nRequires free token from Mapbox \nmapbox.com",
"createdAt": "2026-11-20T02:29:27.733Z",
"likeCount": 0,
"repostCount": 0,
"replyCount": 0,
"quoteCount": 0,
"langs": [
"en"
],
"hashtags": [],
"hasEmbed": true,
"url": "https://bsky.app/profile/mrg9999.bsky.social/post/3n2pk3qabsc2m",
"mode": "search"
},
{
"uri": "at://did:plc:ibi6xtazwd27e55wi5irwheo/app.bsky.feed.post/3n2pk2tk2yc2d",
"cid": "bafyreiffmgvxbzxa452wwu4mqhs2efeasr2x2ypuhdrtrxhtwz3rt2nrwa",
"authorHandle": "astridoverthere.bsky.social",
"authorDid": "did:plc:ibi6xtazwd27e55wi5irwheo",
"authorDisplayName": "I said abolish and I fucking meant it",
"text": "Haven't tried it yet but this was recommended as an open source alternative. manoharys.github.io/paperwall/",
"createdAt": "2026-11-20T02:28:57.645Z",
"likeCount": 1,
"repostCount": 0,
"replyCount": 0,
"quoteCount": 0,
"langs": [
"en"
],
"hashtags": [],
"hasEmbed": true,
"url": "https://bsky.app/profile/astridoverthere.bsky.social/post/3n2pk2tk2yc2d",
"mode": "search"
}
]Input
| Field | Type | Required | Description | Default |
|---|---|---|---|---|
mode | string | Yes | What to scrape: search (posts by keyword/hashtag), author_feed (recent posts by a handle), thread (full thread with nested replies), profile (profile metadata), followers (follower graph), follows (following list). | search |
query | string | No | Keyword, hashtag, or query string (e.g. 'artificial intelligence', '#bluesky', 'startup'). Required in 'search' mode. | artificial intelligence |
handle | string | No | Bluesky handle (e.g. 'bsky.app', 'jay.bsky.team') or DID ('did:plc:...'). Required in author_feed, profile, followers, follows modes. | - |
postUri | string | No | Full AT-URI ('at://did:plc:.../app.bsky.feed.post/...') or web URL ('https://bsky.app/profile/.../post/...'). Required in 'thread' mode. | - |
sort | string | No | Sort order for search mode: 'latest' (chronological) or 'top' (highest engagement). | latest |
maxItems | integer | No | Maximum number of posts or profiles to scrape. Pay-per-event charges only for items successfully extracted. | 100 |
includeReplies | boolean | No | When in 'thread' mode, whether to recursively traverse and extract nested reply posts. | true |
proxyConfiguration | object | No | Select Apify Proxy (RESIDENTIAL recommended for high-volume author feeds or searches to avoid rate limits). | {"useApifyProxy":true} |
Example input
{
"mode": "search",
"query": "artificial intelligence",
"handle": "bsky.app"
}Pricing
| Event | What it means | Price | Lowest tier |
|---|---|---|---|
post | One Bluesky post returned to the dataset (search, author feed, or thread). | $0.001 | $0.001 |
apify-actor-start | Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event). | $0.00005 | $0.00005 |
profile | One Bluesky profile or graph edge (profile, follower, or follow). | $0.002 | $0.002 |
$1.00 for 1,000 post scraped units at the listed price.
Prices from the Apify Store on 20 November 2026. Apify shows the final price before each run.
How it compares with other Apify actors
Price per 1,000 posts at Apify Store list prices. Every row is a live listing on the Store, read on 20 Nov 2026, so a buyer can check each number at the source.
| Actor | Price per 1,000 posts (Free plan) | Higher plans (Gold) | Start fee per run | Platform usage | Users | Rating | Last build |
|---|---|---|---|---|---|---|---|
| Bluesky Scraper API — Posts, Profiles, Threads & Followers This API | $1.00 | $1.00 | $0.00005 | Included | 2 | No reviews yet | 18 Nov 2026 |
| Bluesky Scraper | $1.00 | $0.6 | $0.005 | Included | 387 | 5.0 (1 review) | 14 Sep 2026 |
| Bluesky Scraper | Enterprise Grade | $1.49 | $1.49 | None | Included | 249 | 5.0 (2 reviews) | 5 May 2026 |
| Bluesky Posts Scraper | $1.10 | $0.72 | $0.004 | Paid separately | 440 | 4.5 (22 reviews) | 21 Apr 2026 |
| Bluesky Scraper — Posts, Profiles & Search | $3.00 | $3.00 | None | Included | 82 | No reviews yet | 24 Sep 2026 |
Where Bluesky Scraper is stronger
Where Bluesky Scraper is stronger
- Explicit events for profiles and for follower and following lists
- Thread depth and per post reply caps as inputs
- People search by handle or name
Where this API is stronger
- Follower and following rows billed at the profile rate rather than as separate events
- One documented row shape per item type across every mode
- Single post event plus a minimal start event, so short runs stay cheap
Where Bluesky Scraper | Enterprise Grade is stronger
Where Bluesky Scraper | Enterprise Grade is stronger
- Min like, repost and reply filters plus domain and exact URL filters
- Optional sentiment scores and content category labels
- Full comment threads with reply depth and parent links
Where this API is stronger
- Profiles and follower graphs as well as posts
- Payloads carry the requested post fields without analysis columns added
- Posts charged per row as they are pushed
Where Bluesky Posts Scraper is stronger
Where Bluesky Posts Scraper is stronger
- Established listing with its own user base on the Store
- Date range and language filters on searches
- Compact output with the fields most dashboards use
Where this API is stronger
- Profiles, author feeds, threads and follower graphs as well as search
- One row shape per item type across all modes
- Minimal start event, so short query runs stay inexpensive
Where Bluesky Scraper — Posts, Profiles & Search is stronger
Where Bluesky Scraper — Posts, Profiles & Search is stronger
- Engagement score and media counts computed on each post
- Custom feed URIs and thread URIs as inputs
- Hashtag, domain, mention and author filters
Where this API is stronger
- Separate profile event so follower work is priced explicitly
- Hashtags extracted per post alongside quote and reply counts
- Minimal start event on top of the post charge
Bluesky scraping is a small, active lane where several actors read the same public AT Protocol. The automation-lab and fatihtahta listings differ mostly in filters and analysis columns, while lexis-solutions and cryptosignals keep output lean. Ours covers search, profiles, threads and follower graphs in one actor with one row shape per item type.
Prices are Apify Store list prices, checked 20 Nov 2026. Platform usage 'Paid separately' means Apify bills compute on top of the event price. Check each listing before you buy.
How to run it
- Pick a mode: search, author_feed, thread, profile, followers or follows.
- Fill the field that mode needs: query for search, handle for author_feed, profile, followers and follows, postUri for thread.
- For search, set sort to latest or top; for thread, set includeReplies true to walk nested replies.
- Set maxItems, for example 50, then run the actor. Only successfully extracted items are charged.
- Read the dataset in Apify Console or export it as JSON or CSV, or pull it through the Apify API.
cURL
curl -X POST "https://api.apify.com/v2/acts/subimpact~bluesky-scraper-api/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"mode":"search","query":"artificial intelligence","handle":"bsky.app"}'Python
from apify_client import ApifyClient
client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("subimpact/bluesky-scraper-api").call(run_input={"mode":"search","query":"artificial intelligence","handle":"bsky.app"})
for item in client.dataset(run["default_dataset_id"]).iterate_items():
print(item)JavaScript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('subimpact/bluesky-scraper-api').call({"mode":"search","query":"artificial intelligence","handle":"bsky.app"});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);MCP
claude mcp add subimpact-data -e APIFY_TOKEN=<YOUR_APIFY_TOKEN> -- npx -y @subimpact/data-mcp
# Then ask your agent to use the bluesky tool.n8n
Use the Apify node (Run an Actor).
Actor ID: subimpact/bluesky-scraper-api
Input JSON: paste the example input above.
MCP users: @subimpact/data-mcp exposes these actors as tools, so an agent can call bluesky directly.
Limits
- Public AT Protocol data only, so nothing from accounts that have deleted or hidden a post is available.
- Follower graph crawls are billed per edge and grow quickly on large accounts.
- Thread mode returns only the replies the protocol exposes for that post.
- Heavy search and author feed volume may need residential proxies to avoid rate limits.
Questions people ask
What does a run cost?
Posts cost $0.001 each, which is $1.00 per 1,000, and profiles or graph edges cost $0.002 each, or $2.00 per 1,000. There is also a small start event of $0.00005. Items that fail to extract are not charged, and platform usage is included in the event prices.
Do I need a Bluesky account or an app password?
No. The actor reads the public AT Protocol, so there is no login, no app password and no risk to a personal account. Public posts and profiles are what you get, and the same request works from Apify Console, the API, a client library or an MCP client.
How many posts can one search return?
maxItems sets the ceiling for posts or profiles in a run. Search pages are walked until that limit is reached or the protocol returns no more results. For heavy volume, residential proxies are recommended in the proxy field to keep rate limits from trimming a run short.
Can I get replies nested under a post?
Yes, in thread mode. Pass the post URI or its bsky.app URL and set includeReplies true to traverse nested replies recursively. Each reply arrives as its own row with text, author handle, metrics and a url, so you can rebuild the tree from parent links in the thread.
Which engagement metrics are included?
Every post row carries likeCount, repostCount, replyCount and quoteCount, plus hashtags, langs and a hasEmbed flag for media or quoted posts. Profiles carry followersCount, followsCount and postsCount, so reach and activity can be attached to the posts you collect.
Can I scrape follower and following lists?
Yes. Modes followers and follows walk the graph in either direction for one handle, returning profile rows with handle, DID, displayName and bio. Graph edges are billed at the profile price, so a large follower crawl costs more per item than a post search.
What output formats are available?
JSON and CSV from the Apify Console, and JSON through the Apify API, with one row per post, profile or graph edge. Rows include a mode field naming the run type, so results from different modes can share one dataset without losing which mode produced them.
Need a data source that is not here?
We build and run scrapers for sites that have no public API. Tell us the site, the fields and how often you need them.