Creator and account research
Pull a profile with follower, post and like counts, its engagement rate and estimated reach, then read its latest posts. Vet accounts before a partnership or a pitch.
- 1profile-info
- 2user-posts
- Shortlist
Profiles, account feeds and full post threads with replies, plus computed engagement rate, language and estimated reach: every Bluesky endpoint Scrapier ships, each returning typed JSON in the same response envelope. Public data only.
Pick the data you need. Each endpoint takes a handle or a post link and gives you clean JSON back, for 1 or 2 credits per successful call.
GET/api/v2/bluesky-profile-info/Bio, follower, following, post and like counts for one handle, with engagement rate and estimated reach.
GET/api/v2/bluesky-user-posts/An account's posts, a page at a time, with like, reply, repost and quote counts and media.
GET/api/v2/bluesky-single-posts/One post by URL with its reply thread, row by row, and per-post engagement metrics.
INkeywordsPublic emails found on Bluesky pages for a keyword, with the page title, description and URL of each match.
INkeywordsPublic phone numbers on Bluesky pages for a keyword and country, with the dial code, page title and URL.
Pick an endpoint, fill in the input and press Run. Without a key you see the catalog sample and nothing is billed. With your API key it runs a real call from your browser.
Every successful call costs 1 credit, whether the page holds one profile or a page of comments. Failed calls cost nothing. A free tier lets you try it first.
On Pro, 1,000 calls at 1 credit cost $1.58. Scale brings that to $1.20, so 250,000 Bluesky calls a month is $299.
See all plans →| Plan | Price / mo | Credits / mo | Per 1,000 calls |
|---|---|---|---|
| Free | $0 | Free tier | — |
| Hobby | $29 | 15,000 | $1.93 |
| Pro | $79 | 50,000 | $1.58 |
| Scale | $299 | 250,000 | $1.20 |
Built to be easy to start with, even if you've never scraped a website. Here's how to get Bluesky data in a few minutes:
espn.com, or one post URL per call.next_cursor; pass it back as cursor for the next page.compute_metrics adds engagement rate, language and category; turn it off when you only need the raw counts.X-API-Key header, or ask your AI agent over MCP.Two ways in. Use whichever matches what you already have.
You already know which accounts you want.
bsky.appespn.comYou already have the links to the pages you want.
bsky.app/profile/bsky.app/post/3mk4lzkrnk22d// GET /api/v2/bluesky-profile-info/ { "handles": "bsky.app", "compute_metrics": "true", "feed_sample": "30", "reach_sample": "5", "amplifier_pages": "1", "count_likes": "true", "likes_max_posts": "1000", "page_fallback": "true" }
// GET /api/v2/bluesky-user-posts/ { "handles": "espn.com", "filter": "posts_and_author_threads", "include_pins": "true", "compute_metrics": "true", "video_duration": "true" }
// GET /api/v2/bluesky-single-posts/ { "urls": "https://bsky.app/profile/bsky.app/post/3mk4lzkrnk22d", "depth": "6", "parent_height": "80", "max_replies": "0", "reply_index": "true", "reply_sort": "api", "compute_metrics": "true", "estimate_reach": "true", "reach_max_amplifiers": "100", "video_duration": "true" }
| Send this | Parameter | And you can get |
|---|---|---|
| Handle | handles | Profile details with computed metrics, or the account's posts |
| Handle + filter | handles · filter | Posts only, posts with replies, or posts and author threads |
| Post URL | urls | That post and its reply thread, row by row |
Optional on list endpoints: cursor (pass back next_cursor for the next page). Auth is one header: X-API-Key. Send parameters in the query string (GET) or as a JSON body (POST).
The one thing to know: each data type has its own shape. Field names stay the same on every call, so code and agents read them directly. Samples below come from the live catalog.
// GET /api/v2/bluesky-profile-info/?handles=bsky.app // one item of data.profile · catalog sample { "input_handle": "espn.com", "handle": "espn.com", "did": "did:plc:x7d6j54pm22ufehkes6jo4jf", "status": "ok", "note": null, "http_status": 200, "id": "did:plc:x7d6j54pm22ufehkes6jo4jf", "username": "espn.com", "display_name": "ESPN", "avatar_url": "https://cdn.bsky.app/img/avatar/plain/did:plc:x7d6j54pm22ufehkes6jo4jf/bafkreie4oxawqqsfzvk47ysr3unsnmviedzpylxmwxnpa534to2bzas4ie", "bio": "Serving sports fans. Anytime. Anywhere.", "verified": true, "followers": 296582, "following": 32, "posts_count": 872, "likes_count": 220484, "url": "https://bsky.app/profile/espn.com", "joined_at": "2024-11-25", "associated": { "lists": 0, "feedgens": 0, "starter_packs": 0, "labeler": false, "activity_subscription": { "allow_subscriptions": "followers" } }, "labels": [], "verification": { "verifications": [ { "issuer": "did:plc:z72i7hdynmk6r22z27h6tvur", "issuer_display_name": "Bluesky", "issuer_handle": "bsky.app", "uri": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.graph.verification/3lndppjqgb72f", "is_valid": true, "created_at": "2025-04-21T10:44:20.398Z" } ], "verified_status": "valid", "trusted_verifier_status": "none" }, "indexed_at": "2024-12-19T20:49:48.843Z", "computed": { "engagement_rate": 0.0512, "language": "en", "content_category": "sports", "estimated_reach": 438639 }, "partial": false, "warnings": [], "stats": { "requests": 28, "retries": 0, "api_calls": 28, "page_loads": 0, "proxy": true, "source": "api", "posts_sampled": 30, "feed_sample": 30, "reach_posts_sampled": 5, "amplifiers_resolved": 174, "likes_posts_scanned": 872, "likes_count_complete": true, "language_source": "post_text+langs", "category_keywords": [ "espn", "sports" ] }, "duration_ms": 17756, "scraped_at": "2026-09-22T08:31:44.102Z" }
// GET /api/v2/bluesky-user-posts/?handles=espn.com // one item of data.posts · catalog sample { "input_handle": "espn.com", "handle": "espn.com", "did": "did:plc:x7d6j54pm22ufehkes6jo4jf", "status": "ok", "position": 1, "post_id": "3muznlkmspz2x", "uri": "at://did:plc:x7d6j54pm22ufehkes6jo4jf/app.bsky.feed.post/3muznlkmspz2x", "cid": "bafyreiceaay7jrgqznvxhttsmizofewx3mj6bwebjtz76nd2wh4hix4fty", "url": "https://bsky.app/profile/espn.com/post/3muznlkmspz2x", "text": "One more sleep until NFL football is BACK. 🏈", "published_at": "2026-09-08T18:27:24.700Z", "indexed_at": "2026-09-08T18:27:30.159Z", "author_handle": "espn.com", "author_did": "did:plc:x7d6j54pm22ufehkes6jo4jf", "author_display_name": "ESPN", "like_count": 85, "reply_count": 8, "repost_count": 11, "quote_count": 6, "bookmark_count": 0, "is_pinned": false, "is_pinned_copy": false, "is_repost": false, "is_reply": false, "media_urls": [ "https://video.bsky.app/watch/.../playlist.m3u8" ], "thumbnail_url": "https://video.bsky.app/watch/.../thumbnail.jpg", "duration_seconds": 34.567, "post": { "id": "3muznlkmspz2x", "url": "https://bsky.app/profile/espn.com/post/3muznlkmspz2x", "content": { "text": "One more sleep until NFL football is BACK. 🏈", "...": "..." }, "author": { "username": "espn.com", "display_name": "ESPN", "verified": true, "did": "did:plc:x7d6j54pm22ufehkes6jo4jf", "...": "..." }, "engagement": { "views": null, "likes": 85, "comments": 8, "shares": 11, "saves": 0, "quote_count": 6 }, "flags": { "nsfw": false, "spoiler": null, "pinned": false, "deleted": false }, "published_at": "2026-09-08T18:27:24.700Z", "record": { "$type": "app.bsky.feed.post", "...": "..." }, "embed": { "$type": "app.bsky.embed.video#view", "...": "..." }, "...": "(same shape as the v1 row)" }, "computed": { "engagement_rate": 0.0371, "language": "en", "content_category": "sports", "estimated_reach": null }, "category_keywords": [ "football", "nfl" ], "account_followers_count": 296583, "account_posts_count": 872, "filter": "posts_no_replies", "pagination": { "page": 1, "cursor_sent": null, "next_cursor": "2025-09-25T17:06:11.912Z", "has_more": true }, "scraped_at": "2026-09-22T08:47:10.412Z" }
// GET /api/v2/bluesky-single-posts/?urls=https://bsky.app/profile/bsky.app/post/3mk4lzkrnk22d // one item of data.rows · catalog sample { "input_url": "https://bsky.app/profile/bsky.app/post/3mk4lzkrnk22d", "post_uri": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mk4lzkrnk22d", "row_type": "post", "status": "ok", "note": null, "http_status": null, "position": 1, "depth": 0, "thread_index": null, "parent_uri": null, "root_uri": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mk4lzkrnk22d", "is_reply": false, "post_id": "3mk4lzkrnk22d", "uri": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mk4lzkrnk22d", "url": "https://bsky.app/profile/bsky.app/post/3mk4lzkrnk22d", "text": "v1.121 is live!\n\nWe've increased the quality of photos in posts by doubling the max file size to 2MB and the resolution limit to 4000x4000. \n\nPlus, posts with multiple photos now appear in a carousel so you can show off your photography in all its glory.", "published_at": "2026-04-23T19:39:35.560Z", "langs": [ "en" ], "author_handle": "bsky.app", "author_did": "did:plc:z72i7hdynmk6r22z27h6tvur", "author_display_name": "Bluesky", "like_count": 7207, "reply_count": 2110, "repost_count": 1079, "quote_count": 2077, "bookmark_count": 0, "embed_type": "video", "media_urls": [ "https://video.bsky.app/watch/did%3Aplc%3Az72i7hdynmk6r22z27h6tvur/.../playlist.m3u8" ], "thumbnail_url": "https://video.bsky.app/watch/did%3Aplc%3Az72i7hdynmk6r22z27h6tvur/.../thumbnail.jpg", "duration_seconds": 17.3, "labels": [], "flags": { "nsfw": false, "pinned": false, "deleted": false }, "post": { "uri": "at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mk4lzkrnk22d", "author": { "handle": "bsky.app", "...": "..." }, "record": { "$type": "app.bsky.feed.post", "...": "..." }, "embed": { "$type": "app.bsky.embed.video#view", "...": "..." }, "like_count": 7207, "reply_count": 2110, "repost_count": 1079, "quote_count": 2077, "id": "3mk4lzkrnk22d", "url": "https://bsky.app/profile/bsky.app/post/3mk4lzkrnk22d", "flags": { "nsfw": false, "pinned": false, "deleted": false }, "...": "(the postView verbatim, keys snake_cased)" }, "thread_context": {}, "computed": { "engagement_rate": 0.0356, "language": "en", "content_category": "other", "estimated_reach": 35288055 }, "threadgate": null, "author_followers_count": 34997628, "partial": true, "warnings": [ "reach estimate covers 100 of 3156 amplifiers (reach_max_amplifiers=100)" ], "stats": { "requests": 15, "api_calls": 12, "video_lookups": 1, "index_calls": 1, "proxy": false, "replies_requested": 200, "replies_available": 2110, "replies_from_thread": 196, "replies_index_total": 2114, "replies_index_hidden": 4, "replies_from_index": 4, "reach_amplifiers_resolved": 100, "reach_truncated": true, "replies_total": 683, "replies_top_level": 200, "replies_max_depth": 6, "repliers": 516, "language_source": "post_text", "rows_total": 684, "elapsed_ms": 7490, "...": "..." }, "scraped_at": "2026-09-22T10:51:34.102Z" }
Every response is {"success": true, "data": {…}}: your input echoed back, the result under its own key (profile, posts, comments…) and next_cursor for the next page.
Public Bluesky data powers creator research, engagement benchmarking, conversation analysis and news monitoring. Here are four common jobs, and the Bluesky scraper endpoints each one chains together.
Pull a profile with follower, post and like counts, its engagement rate and estimated reach, then read its latest posts. Vet accounts before a partnership or a pitch.
Compare accounts in your space on engagement rate and on likes, reposts and quotes per post. See which formats and topics get the most reaction.
Fetch one post with its full reply thread, row by row with depth and parent, to study how people respond to an announcement or a news story.
Follow the feeds of news outlets, competitors or your own brand accounts on a schedule and keep every new post with its engagement counts.
Bluesky Scraper fetches clean, structured Bluesky data at low cost: built for creator research, engagement analysis, news monitoring and AI agents.
Each request reads Bluesky at call time, and the response says when in scraped_at.
Handles, counts and timestamps as plain fields, not nested AT Protocol records, ready for code, sheets or an LLM.
Engagement rate, language, content category and estimated reach come back with profiles and posts.
Profiles, feeds and threads share the same envelope and auth.
The Scrapier MCP server reaches every endpoint from Claude Code, Cursor, Windsurf and VS Code with one command.
Plain REST: Python, Node.js, cURL, n8n, Make, Zapier or Google Sheets.
Public data only. None of the 3 live endpoints needs a Bluesky account or app password.
Feeds and threads return next_cursor; run up to 3 requests in parallel per key.
1 or 2 credits per call, however many items the page holds. Failed calls are never billed.
Bluesky's AT Protocol API is open and free for public reads, but you work with DIDs, raw records, cursors and rate limits yourself, and it computes no metrics. Scrapier returns flat JSON with engagement rate and estimated reach, through the same key you use for 34 other platforms.
Any non-2xx response is free, so retries cost nothing.
At 2 credits a call; feeds and threads cost 1 credit. No compute units or bandwidth to estimate.
3 live endpoints take a handle or URL: no app password, DID lookup or record parsing.
The same key and JSON envelope cover X, Threads, Instagram, TikTok and more.
| Feature | Scrapier Bluesky Scraper | Bluesky AT Protocol API | DIY scraper |
|---|---|---|---|
| Whose data | Any public account or post | Any public account or post | Any public account |
| Setup | One API key | No key for public reads; learn the AT Protocol | Proxies or API client, parsers |
| Output | Flat JSON with computed metrics | Raw AT Protocol records | Whatever you build |
| Cost | From $1.20 per 1,000 calls | Free, within Bluesky's rate limits | Servers and engineering time |
| AI agents | MCP server included | Not included | Build your own |
No. All three live Bluesky endpoints read public data and take a handle or a post URL. You only need your Scrapier API key in the X-API-Key header; no app password or Bluesky login is involved.
The AT Protocol API is free and open, and it is a good choice if you want raw records. Scrapier saves the work around it: handle to DID lookups, flat fields, computed engagement rate and reach, and the same JSON envelope as 34 other platforms.
With compute_metrics on, profiles and posts come back with a computed object: engagement rate, language, content category and estimated reach. Turn it off when you only need the raw like, reply, repost and follower counts.
Call bluesky-single-posts with the post URL. It returns the post and its reply thread as rows, each with depth, parent and root URI, author and counts. Use depth and parent_height to control how far the thread goes.
As many as Bluesky shows publicly. bluesky-user-posts returns a page at a time with next_cursor; pass it back as cursor for the next page. Each page is one call at 1 credit.
It depends on what you collect, where you are and how you use it, so this is not legal advice. Scrapier returns publicly visible data only. Some of it can be personal data under GDPR or CCPA, so collect only what you have a legitimate reason to use.
Yes. Any tool that can make an HTTP request works: n8n, Make, Zapier, Google Sheets, Airbyte or your own code. Send your key in the X-API-Key header and read the JSON response.
Yes. Run claude mcp add -t http scrapier https://mcp.scrapier.io/mcp with your key in an X-API-Key header. The agent finds the right Bluesky endpoint with search_endpoints and calls it with run_scrape, in Claude Code, Cursor or Windsurf.
Check the status code first: 401 means the X-API-Key header is missing, 403 an invalid key, 402 no credits left, 429 too many requests (wait Retry-After seconds). If it's still wrong, report it with the request and the response.
A profile costs 2 credits per successful call; an account feed page or a post thread costs 1 credit. Failed calls are free. Plans: Hobby $29 for 15,000 credits, Pro $79 for 50,000, Scale $299 for 250,000, Enterprise custom. A free tier lets you try it first.
Run up to 3 requests in parallel per API key. If you go faster, the API answers 429 with a Retry-After header: wait that many seconds and retry. 429 and 5xx responses are never billed, and long-running endpoints need a client timeout of 210 seconds or more.
Use the requests library: requests.get("https://proxy.scrapier.io/api/v2/bluesky-profile-info/", headers={"X-API-Key": key}, params={"handles": "espn.com"}, timeout=210). The response is JSON, so read r.json()["data"]["profile"] directly; there is no HTML to parse. Loop over your list for more handles.
Free API key. No sales call, no proxy setup, and failed calls are free.