Bluesky Scraper – Posts, Profiles & Search

sfoln/bluesky-scraper · Social media, Lead generation, News On request

Bluesky posts and profiles without login: keyword search (latest or top, date and language filters), the posts of any account, full reply threads, and profiles with follower, following and post counts. Text, links, images, likes, reposts, replies. $0.80 per 1,000 posts, $2 per 1,000 profiles.

Request access Run it$0.80 / 1,000 bluesky post, more below

About

What it does

Scrape Bluesky posts and profiles without logging in: keyword search (latest or top, with date and language filters), the posts of any account, full reply threads, and profiles with follower, following and post counts. One clean record per post or profile, for social listening, brand and competitor monitoring, research datasets, lead lists and AI agents. $0.80 per 1,000 posts, $2 per 1,000 profiles, no start fee; unknown accounts, deleted posts and errors are free.

Price

Price per delivered record

Event	Price	Per 1,000	Charged for
Bluesky post `post`	$0.0008	$0.80 / 1,000	One post row (search result, post of an account, or post of a thread) with its text, author, links, media and engagement counts.
Bluesky profile `profile`	$0.002	$2 / 1,000	One profile record (handle, DID, name, bio, avatar, follower, following and post counts, creation date).

Apify free plan: up to 10 items per run. Paid plans have no per-run cap; set maxTotalChargeUsd to cap spend.

Run

Call it from code, an agent or the Console

This API is private on Apify for now. Email us and we will publish it for you, usually within two working days. The calls below work once it is public. contact@sfoln.com

curl · synchronous run, rows in the response

curl -X POST "https://api.apify.com/v2/actors/sfoln~bluesky-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchQueries":["bluesky"],"maxPostsPerInput":10}'

mcp.json · hosted Apify MCP server

{
  "mcpServers": {
    "apify": {
      "type": "http",
      "url": "https://mcp.apify.com?tools=sfoln/bluesky-scraper"
    }
  }
}

asynchronous run · for large batches

POST https://api.apify.com/v2/actors/sfoln~bluesky-scraper/runs?maxTotalChargeUsd=1
GET  https://api.apify.com/v2/actor-runs/{runId}            # until status is SUCCEEDED
GET  https://api.apify.com/v2/datasets/{defaultDatasetId}/items?format=json

Authenticate with an Apify API token. MCP clients can instead sign in with OAuth when prompted. Example prompt for an agent: Find the 50 latest Bluesky posts that mention "apify" and summarise what people say about it.

Input

Input fields

Pick a mode and fill its list: search queries, account handles (for their posts or their profiles) or post URLs (for reply threads). Each query, account or post is one item with its own summary in the dataset.

Field	Type	Default	Meaning
`mode`	`string`	`"search"`	Mode search: posts matching keywords. author-feed: the posts of accounts. profiles: one profile record per account. threads: a post with its parents and replies. One of `"search"`, `"author-feed"`, `"profiles"`, `"threads"`.
`searchQueries`	`array`	—	Search queries For the search mode: keywords, phrases or hashtags, one per line. Bluesky's search syntax works too ("exact phrase", from:handle, domain:example.com). Accounts on the Apify free plan can process up to 10 items per run (an item is one query, account or post).
`handles`	`array`	—	Accounts For the author-feed and profiles modes: handles (jay.bsky.team, @bsky.app), DIDs (did:plc:…) or profile URLs, one per line. A bare name means name.bsky.social.
`postUrls`	`array`	—	Post URLs For the threads mode: post URLs (https://bsky.app/profile/bsky.app/post/3l6oveex3ii2l) or at:// URIs, one per line.
`maxPostsPerInput`	`integer`	`100`	Max posts per item Posts returned per query, account or thread (1–10,000). Range 1–10000.
`sort`	`string`	`"latest"`	Search order Search mode: latest (newest first, pages back in time) or top (Bluesky's ranking; first 100 results only). One of `"latest"`, `"top"`.
`since`	`string`	—	Since Search mode: only posts from this date or date-time on (2026-01-31 or 2026-01-31T12:00:00Z).
`until`	`string`	—	Until Search mode: only posts before this date or date-time.
`lang`	`string`	—	Language Search mode: only posts in this language (en, de, ja, pt-BR…).
`feedFilter`	`string`	`"posts"`	Posts of accounts: filter author-feed mode: posts (no replies), replies (posts and replies), media (posts with images or video), threads (posts and the account's own threads) or videos. One of `"posts"`, `"replies"`, `"media"`, `"threads"`, `"videos"`.
`includeReposts`	`boolean`	`false`	Include reposts author-feed mode: also return the posts the account reposted (marked isRepost).
`threadDepth`	`integer`	`6`	Reply depth threads mode: levels of replies to follow (0 = the post only). Range 0–1000.
`includeParents`	`boolean`	`true`	Include parent posts threads mode: also return the posts above the given one, up to the thread's root.
`maxItems`	`integer`	`1000`	Max items Safety cap on queries, accounts or posts processed in this run; the rest is reported as dropped. Range 1–10000.
`concurrency`	`integer`	—	Concurrency Items processed in parallel (1–10). Default: 2 for search, 3 for posts and threads, 10 for profiles (fetched 25 per call). Range 1–10.
`includeRaw`	`boolean`	`false`	Include raw upstream response Attach Bluesky's unmodified JSON to each record under raw (larger output).

Example input

{
  "searchQueries": [
    "bluesky"
  ],
  "maxPostsPerInput": 10
}

Output

One record per input item

Records land in the run's dataset; a synchronous call returns them directly. Each has a status (ok is charged; everything else is free) and a charged flag. The run's OUTPUT record totals items and charges.

Field	Type	Meaning
`input`	`string \| object`	Input The input item this record belongs to (the app, keyword, chart, account or post, with its country or mode).
`status`	`string`	Status ok \| not_found \| error \| skipped_invalid \| skipped_budget \| skipped_free_plan \| skipped_unmetered e.g. `"ok"`
`charged`	`boolean`	Charged Whether this record incurred a pay-per-event charge.
`chargedEvent`	`string`	Charged event Pay-per-event event charged for this record (present only when charged).
`chargedCount`	`integer`	Events charged Events actually charged when the charge came back short of the requested count (present only then; a warning explains it).
`source`	`string`	Source Upstream data source.
`fetchedAt`	`string`	Fetched at ISO timestamp.
`error`	`object`	Error { code, message, provider?, status? } when status is not ok. Codes set by the runtime: budget_exhausted, free_plan_limit, unmetered, aborted, charge_failed, record_too_large, invalid_record, dataset_push_failed; upstream codes: auth, insufficient_credits, rate_limit, timeout, network, server, client, invalid_response, not_found.
`warnings`	`array`	Warnings Notes about this record, e.g. a charge that came back short.
`raw`	`object`	Raw Bluesky's unmodified post or profile view (only with includeRaw).
`recordType`	`string`	Record type post, profile, or summary (one per query, account or thread: what was delivered and why it stopped).
`position`	`integer`	Position Order of this row among the rows of its input (1-based).
`uri`	`string`	Post URI at:// URI of the post.
`cid`	`string \| null`	CID Content ID of the post version.
`url`	`string \| null`	URL bsky.app link of the post or profile.
`postId`	`string \| null`	Post ID Record key of the post (last part of its URL).
`authorDid`	`string \| null`	Author DID Permanent ID of the author.
`authorHandle`	`string \| null`	Author handle Handle of the author, e.g. bsky.app.
`authorDisplayName`	`string \| null`	Author name Display name of the author.
`authorAvatar`	`string \| null`	Author avatar Avatar image URL of the author.
`text`	`string`	Text Post text.
`createdAt`	`string \| null`	Created Posts: when the post was written (ISO). Profiles: when the account was created.
`indexedAt`	`string \| null`	Indexed When Bluesky indexed the post or profile (ISO).
`langs`	`array`	Languages Language codes the author set on the post.
`replyCount`	`integer`	Replies Replies at fetch time.
`repostCount`	`integer`	Reposts Reposts at fetch time.
`likeCount`	`integer`	Likes Likes at fetch time.
`quoteCount`	`integer`	Quotes Quote posts at fetch time.
`isReply`	`boolean`	Is reply True when the post replies to another post.
`replyParentUri`	`string \| null`	Reply to URI of the post this one replies to.
`replyRootUri`	`string \| null`	Thread root URI of the first post of the thread.
`isQuote`	`boolean`	Is quote True when the post quotes another post.
`quotedPostUri`	`string \| null`	Quoted post URI of the quoted post.
`embedType`	`string \| null`	Embed images, gallery, video, external (link card), record (quote) or recordWithMedia.
`links`	`array`	Links URLs linked in the text and the link card.
`mentions`	`array`	Mentions Handles (or DIDs) mentioned in the text.
`hashtags`	`array`	Hashtags Hashtags of the post, without #.
`images`	`array`	Images Attached images: { url, thumbUrl, alt }.
`videoUrl`	`string \| null`	Video HLS playlist URL of an attached video.
`videoThumbnailUrl`	`string \| null`	Video thumbnail Thumbnail URL of an attached video.
`externalLink`	`object \| null`	Link card Link card of the post: { url, title, description, thumbUrl }.
`labels`	`array`	Labels Moderation and self labels on the post or profile.
`isRepost`	`boolean`	Is repost author-feed mode: true when the account reposted this post (includeReposts).
`repostedByHandle`	`string \| null`	Reposted by author-feed mode: the account that reposted it.
`repostedAt`	`string \| null`	Reposted at author-feed mode: when it was reposted.
`threadRole`	`string`	Thread role threads mode: parent, anchor (the requested post) or reply.
`threadDepth`	`integer`	Thread depth threads mode: -n for parents, 0 for the requested post, 1… for replies.
`did`	`string`	DID Profiles: permanent account ID.
`handle`	`string \| null`	Handle Profiles and author-feed summaries: the account handle.
`displayName`	`string \| null`	Name Profiles: display name.
`description`	`string \| null`	Bio Profiles: profile description.
`avatar`	`string \| null`	Avatar Profiles: avatar image URL.
`banner`	`string \| null`	Banner Profiles: banner image URL.
`followersCount`	`integer \| null`	Followers Profiles: followers.
`followingCount`	`integer \| null`	Following Profiles: accounts followed.
`postsCount`	`integer \| null`	Posts Profiles: posts written.
`pinnedPostUri`	`string \| null`	Pinned post Profiles: URI of the pinned post.
`listsCount`	`integer \| null`	Lists Profiles: lists created.
`feedsCount`	`integer \| null`	Feeds Profiles: custom feeds created.
`starterPacksCount`	`integer \| null`	Starter packs Profiles: starter packs created.
`isLabeler`	`boolean`	Labeler Profiles: true for a moderation (labeler) service.
`verified`	`boolean`	Verified Profiles: true when Bluesky shows the account as verified.
`query`	`string`	Query Summary rows (search mode): the query.
`sort`	`string`	Search order Summary rows (search mode): latest or top.
`hitsTotal`	`integer`	Matches Summary rows (search mode): matches Bluesky reported for the query.
`feedFilter`	`string`	Feed filter Summary rows (author-feed mode): posts, replies, media, threads or videos.
`postUri`	`string \| null`	Thread post Summary rows (threads mode): URI of the requested post.
`postsInThread`	`integer`	Posts in thread Summary rows (threads mode): posts Bluesky returned for the thread.
`duplicatesSkipped`	`integer`	Duplicates skipped Summary rows: posts already delivered for an earlier input of the run (not charged again).
`resultsDelivered`	`integer`	Rows delivered Summary rows: posts delivered (and charged) for this item.
`stopReason`	`string`	Stop reason Summary rows: limit, end, free_plan, budget, aborted, deadline, empty_pages, max_pages or error.

Example record

{
  "input": {
    "mode": "search",
    "query": "launch"
  },
  "recordType": "post",
  "position": 1,
  "uri": "at://did:plc:synthetic1aaaaaaaaaaaaaa/app.bsky.feed.post/3mxulfla27c2e",
  "cid": "bafyrei3mxulfla27c2ecid",
  "url": "https://bsky.app/profile/alex-example.bsky.social/post/3mxulfla27c2e",
  "postId": "3mxulfla27c2e",
  "authorDid": "did:plc:synthetic1aaaaaaaaaaaaaa",
  "authorHandle": "alex-example.bsky.social",
  "authorDisplayName": "Alex Example",
  "authorAvatar": "https://cdn.bsky.app/img/avatar/plain/did:plc:synthetic1aaaaaaaaaaaaaa/bafkreiavatar1@jpeg",
  "text": "Launch day 🚀 Notes at example.com/launch, thanks @sam-example.bsky.social #webdev",
  "createdAt": "2026-10-14T21:56:03.120Z",
  "indexedAt": "2026-10-14T21:56:03.120Z",
  "langs": [
    "en"
  ],
  "replyCount": 2,
  "repostCount": 3,
  "likeCount": 10,
  "quoteCount": 1,
  "isReply": false,
  "replyParentUri": null,
  "replyRootUri": null,
  "isQuote": false,
  "quotedPostUri": null,
  "embedType": "external",
  "links": [
    "https://example.com/launch"
  ],
  "mentions": [
    "sam-example.bsky.social"
  ],
  "hashtags": [
    "webdev"
  ],
  "images": [],
  "videoUrl": null,
  "videoThumbnailUrl": null,
  "externalLink": {
    "url": "https://example.com/launch",
    "title": "Launch notes",
    "description": "What shipped today.",
    "thumbUrl": "https://cdn.bsky.app/img/feed_thumbnail/plain/did:plc:synthetic1aaaaaaaaaaaaaa/bafkreithumb1@jpeg"
  },
  "labels": [],
  "status": "ok",
  "charged": true,
  "chargedEvent": "post",
  "source": "bluesky",
  "fetchedAt": "2026-10-14T22:00:00.000Z"
}

FAQ

Questions

Do I need a Bluesky account or an app password?: No. The Actor reads Bluesky's public API, the same data the Bluesky web app shows to logged-out visitors.
How far back does keyword search go?: With sort "latest", the Actor pages back in time until it has maxPostsPerInput posts or reaches since. Bluesky serves only the first page (up to 100 posts) of a "top" search to logged-out clients.
Why does a post appear only once when two of my queries match it?: Within one run a post is delivered and charged once, under the first input that found it; the summary record of the other input counts it in duplicatesSkipped.

Machine-readable

This page for agents

/actors/bluesky-scraper.json — this API as JSON
/actors/bluesky-scraper.md — this API as Markdown
/catalog.json — the whole catalogue