Bluesky Scraper - Posts, Profiles, Threads & Followers

Extract public Bluesky and AT Protocol data without a browser, proxy, cookie, or login.

This Actor uses the public Bluesky AppView XRPC API (api.bsky.app) and saves clean JSON/CSV-ready records for posts, profiles, author feeds, reply threads, followers, follows, and custom feeds. Every saved row includes stable IDs, a record hash, a scrape timestamp, and source metadata. Each run also writes a RUN_SUMMARY record to the key-value store.

Use Cases

• Social listening and brand monitoring on Bluesky.
• Research datasets for posts, threads, hashtags, and mentions.
• Profile and audience analysis for journalists, agencies, and creators.
• Lead discovery from followers/following lists.
• Daily scheduled monitoring with dedupe by recordId or recordHash.
• AI/LLM workflows that need structured AT Protocol data.

Modes

Mode	What it collects	Best for
profile	Profile details for one or more handles	Fast health checks, profile enrichment
searchPosts	Posts matching a keyword, phrase, or hashtag	Social listening and trend monitoring
authorFeed	Posts from one or more accounts	Creator/account analysis
postThread	A post and nested replies	Conversation analysis
followers	Accounts following a handle	Audience research
follows	Accounts followed by a handle	Network mapping
customFeed	Posts from a public feed generator	Topic/feed monitoring

The default input runs a tiny profile lookup for bsky.app. This is intentional: it gives Apify Store health checks a quick, reliable, low-cost run.

Input

Field	Type	Default	Description
mode	string	profile	One of profile, searchPosts, authorFeed, postThread, followers, follows, customFeed
handles	string array	["bsky.app"]	Handles without @, used by profile/feed/follower modes
searchQuery	string	bluesky	Keyword, phrase, hashtag, or Bluesky search syntax
searchSort	string	latest	latest or top
searchSince	string	empty	Optional start date, YYYY-MM-DD
searchUntil	string	empty	Optional end date, YYYY-MM-DD
searchLang	string	empty	Optional two-letter language code
postUrl	string	empty	Public bsky.app post URL or AT URI
feedUri	string	empty	Public feed generator AT URI
maxItems	integer	10	Maximum posts/profiles to save, 1 to 10000
includeReplies	boolean	false	Include replies in authorFeed mode
includeReposts	boolean	false	Include reposts in authorFeed mode
maxRetries	integer	3	Retries for 429, 5xx, and timeout errors
requestTimeoutSecs	integer	30	Per-request timeout
testMode	boolean	false	Forces a tiny bsky.app profile lookup

Default Example

{}

Search Posts

{
  "mode": "searchPosts",
  "searchQuery": "bluesky lang:en",
  "searchSort": "latest",
  "maxItems": 25
}

Profile And Audience Analysis

{
  "mode": "followers",
  "handles": ["bsky.app"],
  "maxItems": 100
}

Thread Export

{
  "mode": "postThread",
  "postUrl": "https://bsky.app/profile/pfrazee.com/post/3mnsxzydov22d",
  "maxItems": 100
}

Output

Post records include:

• recordType, recordId, recordHash, scrapedAt, source, scrapedMode
• postId, url, text
• authorHandle, authorDid, authorDisplayName
• likeCount, repostCount, replyCount, quoteCount
• createdAt, indexedAt, lang
• tags, mentionedDids
• hasMedia, mediaUrls, mediaAltTexts
• reply and external-link metadata where available

Profile records include:

• recordType, recordId, recordHash, scrapedAt, source, scrapedMode
• did, handle, displayName, description
• followerCount, followingCount, postCount
• avatarUrl, bannerUrl, createdAt, indexedAt, labels

RUN_SUMMARY includes:

• status: SUCCEEDED, NO_RESULTS, or FAILED
• mode, requested_items, saved_items, test_mode
• warnings, errors, dataset_fields_version

Example Output

{
  "recordType": "profile",
  "recordId": "did:plc:z72i7hdynmk6r22z27h6tvur",
  "recordHash": "f0f0a9e2c1...",
  "scrapedAt": "2026-07-03T13:30:00.000Z",
  "source": "bluesky",
  "did": "did:plc:z72i7hdynmk6r22z27h6tvur",
  "handle": "bsky.app",
  "displayName": "Bluesky",
  "description": "Official Bluesky account",
  "followerCount": 1000000,
  "followingCount": 4,
  "postCount": 1000,
  "avatarUrl": "https://cdn.bsky.app/...",
  "bannerUrl": "https://cdn.bsky.app/...",
  "createdAt": "2023-04-12T04:53:57.057Z",
  "indexedAt": "2026-07-03T12:00:00.000Z",
  "labels": null,
  "scrapedMode": "profile"
}

Scheduling And Automation

For daily monitoring:

1. Use a small maxItems value.
2. Schedule the Actor on Apify.
3. Dedupe by recordId.
4. Compare recordHash to detect changed profile/post metadata.
5. Read RUN_SUMMARY from the key-value store for alerting.

API example:

curl -X POST \
  "https://api.apify.com/v2/acts/actorpilot~bluesky-scraper/runs" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"searchPosts","searchQuery":"bluesky lang:en","maxItems":25}'

Limits And Notes

• Only public Bluesky data is returned.
• No private accounts, blocked content, or login-only data is accessed.
• Some Bluesky search behavior can change because it is controlled by the public AppView API.
• Very broad searches or large follower lists can take longer and cost more.
• Search results may return lighter author objects than profile/feed modes.
• NO_RESULTS means the source was reachable but the query/filter returned no items.
• True input or source failures still fail the run and write RUN_SUMMARY.errors.

Why This Actor Instead Of Generic Social Scrapers?

• It uses the official public AT Protocol API instead of browser scraping.
• It includes stable AT URI/DID identifiers for reliable dedupe.
• It writes run summaries for scheduled automation.
• It supports profiles, posts, threads, followers, follows, and feeds in one Actor.
• It is designed for low-cost recurring runs, not heavyweight browser sessions.