# Bluesky Scraper API: Profiles, Posts, Threads | Scrapier (https://scrapier.io/scrapers/bluesky/)

> Bluesky scraper API with 5 endpoints: profiles, feeds and post threads as typed JSON with engagement metrics. 1 or 2 credits per call. Get a free API key.

Last updated: 2026-11-10

## 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.

[Get a free API key →](https://app.scrapier.io/sign-up)

Copy for your AI agent

**5**Bluesky endpoints

**1**credit per successful call

**0**credits for a failed call

**3**need 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.

[### Profile infoStart here

`**GET**/api/v2/bluesky-profile-info/`

Bio, follower, following, post and like counts for one handle, with engagement rate and estimated reach.

1 credit per call_View →Page soon_](https://scrapier.io/scrapers/bluesky/profile/)[### User posts

`**GET**/api/v2/bluesky-user-posts/`

An account's posts, a page at a time, with like, reply, repost and quote counts and media.

1 credit per call_View →Page soon_](https://scrapier.io/scrapers/bluesky/posts/)[### Post and thread

`**GET**/api/v2/bluesky-single-posts/`

One post by URL with its reply thread, row by row, and per-post engagement metrics.

1 credit per call_View →Page soon_](https://scrapier.io/scrapers/bluesky/post/)

### Email finder

`**IN**keywords`

Public emails found on Bluesky pages for a keyword, with the page title, description and URL of each match.

Same API key and JSON envelope

### Phone number finder

`**IN**keywords`

Public phone numbers on Bluesky pages for a keyword and country, with the dial code, page title and URL.

Same API key and JSON envelope

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.

Bluesky**Profile info**Live

Platform

Endpoint

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 →](https://scrapier.io/pricing/)

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

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:

[Get a free API key →](https://app.scrapier.io/sign-up)

1. **Create a free Scrapier account**[Sign up](https://app.scrapier.io/sign-up) with your email and copy your API key.
2. **Pick the endpoint for your data**A profile, an account's posts, or one post with its reply thread.
3. **Add your input**One handle, such as `espn.com`, or one post URL per call.
4. **Page through the results**Feeds and threads return `next_cursor`; pass it back as `cursor` for the next page.
5. **Choose what to compute**`compute_metrics` adds engagement rate, language and category; turn it off when you only need the raw counts.
6. **Run the request**One GET with your key in the `X-API-Key` header, or ask your AI agent over MCP.
7. **Save the results**JSON 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 info`bsky.app`

User posts`espn.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 thread`bsky.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 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).

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. _1_profile-info
2. _2_user-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. _1_profile-info
2. _2_user-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. _1_single-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. _1_user-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.

[Get a free API key →](https://app.scrapier.io/sign-up)[See pricing](https://scrapier.io/pricing/)

**0**Credits for a failed call

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

**$1.20**Per 1,000 calls on Scale

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

**0**Bluesky accounts needed

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

**1 key**For 35 platforms

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 |

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.

Other platforms

## You might also like

[### X (Twitter)

6 endpoints](https://scrapier.io/scrapers/x-twitter/)[### Threads

6 endpoints](https://scrapier.io/scrapers/threads/)[### Truth Social

4 endpoints](https://scrapier.io/scrapers/truth-social/)[### Telegram

2 endpoints](https://scrapier.io/scrapers/telegram/)[### Reddit

9 endpoints](https://scrapier.io/scrapers/reddit/)[### Instagram

20 endpoints](https://scrapier.io/scrapers/instagram/)

Get started

## Start pulling Bluesky data in 60 seconds

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

[Get your API key →](https://app.scrapier.io/sign-up)[Browse all 5 endpoints](#endpoints)

---
Canonical page: https://scrapier.io/scrapers/bluesky/
Site index for AI agents: https://scrapier.io/llms.txt
