New: the Scrapier MCP server. Every scraper in Claude Code with one command. See how →

Bluesky Scraper API: 5 endpoints, structured JSON

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.

Copy for your AI agent
5Bluesky endpoints
1credit per successful call
0credits for a failed call
3need no Bluesky login
Quick answerScrapier returns typed JSON from 5 Bluesky endpoints: profiles, account feeds and post threads with replies, with computed engagement metrics. Public data only and no proxies; no Bluesky login needed. 1 credit per successful call; failed calls are free. Last verified 9 Nov 2026
Endpoints

What data can I extract with Bluesky Scraper?

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.

Playground

Try Bluesky Scraper Live

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.

BlueskyProfile infoLive

Parameters
+ Run live with your API key
Response
Sample dataCatalog sample, run to see live data
Pricing

How much will scraping Bluesky cost?

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 →
PlanPrice / moCredits / moPer 1,000 calls
Free$0Free tier—
Hobby$2915,000$1.93
Pro$7950,000$1.58
Scale$299250,000$1.20
How to

How do I use Bluesky Scraper?

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:

  1. Create a free Scrapier accountSign up with your email and copy your API key.
  2. Pick the endpoint for your dataA profile, an account's posts, or one post with its reply thread.
  3. Add your inputOne handle, such as espn.com, or one post URL per call.
  4. Page through the resultsFeeds and threads return next_cursor; pass it back as cursor for the next page.
  5. Choose what to computecompute_metrics adds engagement rate, language and category; turn it off when you only need the raw counts.
  6. Run the requestOne GET with your key in the X-API-Key header, or ask your AI agent over MCP.
  7. Save the resultsJSON from the API: store it as is, or flatten it to CSV in a few lines.
Input

Input

Two ways in. Use whichever matches what you already have.

1

By username or handle

You already know which accounts you want.

Profile infobsky.app
User postsespn.com
Best fortracking known accounts · one value per call, up to 3 calls in parallel
2

By URL

You already have the links to the pages you want.

Post and threadbsky.app/profile/bsky.app/post/3mk4lzkrnk22d
Best forknown pages · paste the link as it is
Example requests
// 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"
}
Send thisParameterAnd you can get
HandlehandlesProfile details with computed metrics, or the account's posts
Handle + filterhandles · filterPosts only, posts with replies, or posts and author threads
Post URLurlsThat 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).

Output

Output

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"
}

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.

Use cases

What can you do with Bluesky data?

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.

01

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.

  1. 1profile-info
  2. 2user-posts
  3. Shortlist
WeeklyCreator CRM, Sheets
02

Engagement benchmarking

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.

  1. 1profile-info
  2. 2user-posts
  3. Benchmark
WeeklyDashboard
03

Conversation analysis

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.

  1. 1single-posts
  2. Reply dataset
On demandNotebook, LLM
04

News and brand monitoring

Follow the feeds of news outlets, competitors or your own brand accounts on a schedule and keep every new post with its engagement counts.

  1. 1user-posts
  2. Post archive
HourlyDatabase
Features

Features

Bluesky Scraper fetches clean, structured Bluesky data at low cost: built for creator research, engagement analysis, news monitoring and AI agents.

Live data, every call

Each request reads Bluesky at call time, and the response says when in scraped_at.

Typed, flat JSON

Handles, counts and timestamps as plain fields, not nested AT Protocol records, ready for code, sheets or an LLM.

Metrics computed for you

Engagement rate, language, content category and estimated reach come back with profiles and posts.

5 endpoints, one shape

Profiles, feeds and threads share the same envelope and auth.

MCP-ready for AI agents

The Scrapier MCP server reaches every endpoint from Claude Code, Cursor, Windsurf and VS Code with one command.

Works with your stack

Plain REST: Python, Node.js, cURL, n8n, Make, Zapier or Google Sheets.

No login to manage

Public data only. None of the 3 live endpoints needs a Bluesky account or app password.

Pages and threads

Feeds and threads return next_cursor; run up to 3 requests in parallel per key.

Pay per successful call

1 or 2 credits per call, however many items the page holds. Failed calls are never billed.

Why Scrapier

Why choose this Bluesky Scraper?

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.

0Credits for a failed call

Any non-2xx response is free, so retries cost nothing.

$1.20Per 1,000 calls on Scale

At 2 credits a call; feeds and threads cost 1 credit. No compute units or bandwidth to estimate.

0Bluesky accounts needed

3 live endpoints take a handle or URL: no app password, DID lookup or record parsing.

1 keyFor 35 platforms

The same key and JSON envelope cover X, Threads, Instagram, TikTok and more.

FeatureScrapier Bluesky ScraperBluesky AT Protocol APIDIY scraper
Whose dataAny public account or postAny public account or postAny public account
SetupOne API keyNo key for public reads; learn the AT ProtocolProxies or API client, parsers
OutputFlat JSON with computed metricsRaw AT Protocol recordsWhatever you build
CostFrom $1.20 per 1,000 callsFree, within Bluesky's rate limitsServers and engineering time
AI agentsMCP server includedNot includedBuild your own
FAQ

Frequently asked questions

Do I need a Bluesky account to use the Bluesky scraper?

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.

Why use Scrapier when Bluesky has an open API?

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.

What does compute_metrics add?

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.

How do I get the replies to a Bluesky post?

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.

How many posts can I get from an account?

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.

Is it legal to scrape Bluesky?

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.

Can I connect Bluesky data to other tools?

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.

Can I get Bluesky data through an MCP server?

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.

Bluesky Scraper not working?

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.

How much does the Bluesky scraper cost?

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.

What are the Bluesky scraper rate limits?

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.

How do I scrape Bluesky with Python?

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.

Get started

Start pulling Bluesky data in 60 seconds

Free API key. No sales call, no proxy setup, and failed calls are free.