# Bluesky Scraper API — $0.00005/post

> Bluesky scraper API: an account’s public posts with exact likes, reposts, replies, quotes and bookmarks, images, video and link cards. $0.00005 per post.

[Home](https://quanticdata.io/) / [Collectors](https://quanticdata.io/collectors/) / Bluesky Scraper API

[All collectors](https://quanticdata.io/collectors/)

# Bluesky scraper API

Social & communities · v1.0.0 · `bluesky_posts`

$0.00005 / post

$0.05 / 1K · pay per delivered post

A Bluesky scraper API: send a handle, DID or profile URL and get the account’s public posts as rows, newest first, with the text, exact like, repost, reply, quote and bookmark counts, images, video and link cards. Up to 1,000 posts per run, no login and no app password, billed per post delivered.

By [Aldo Morese](https://quanticdata.io/about/), founder of QuanticData · Published Nov 13, 2026

[Get my free API key](https://app.quanticdata.io/register?utm_source=collector-page&utm_medium=website&utm_campaign=data-api&utm_content=bluesky-scraper-api-hero) · [See the request](https://quanticdata.io/collectors/bluesky-scraper-api/#integration)

$0.00005 per delivered post · $2 free every month · Failed runs never billed

On this page:

- [Try it](https://quanticdata.io/collectors/bluesky-scraper-api/#try)
- [What it is](https://quanticdata.io/collectors/bluesky-scraper-api/#what)
- [Limits](https://quanticdata.io/collectors/bluesky-scraper-api/#caps)
- [Output fields](https://quanticdata.io/collectors/bluesky-scraper-api/#output)
- [Inputs](https://quanticdata.io/collectors/bluesky-scraper-api/#input)
- [Pricing](https://quanticdata.io/collectors/bluesky-scraper-api/#pricing)
- [Integration](https://quanticdata.io/collectors/bluesky-scraper-api/#integration)
- [Use cases](https://quanticdata.io/collectors/bluesky-scraper-api/#use-cases)
- [Versus the alternatives](https://quanticdata.io/collectors/bluesky-scraper-api/#compare)
- [FAQ](https://quanticdata.io/collectors/bluesky-scraper-api/#faq)

What it does

## What a Bluesky scraper returns

Bluesky publishes every account’s feed openly, which makes it easy to study and easy to read wrong: a feed mixes the account’s own posts with what it reposted, and a repost carries someone else’s numbers. The collector flags each repost with `is_repost` and names both the original author and the account that reposted it, so your counts measure what you mean.

On 13 November 2026 the latest 50 items of the bsky.app account ran from 15 October to 12 November: 39 were reposts and 11 were Bluesky’s own posts. The most liked item was a repost at 37,303 likes; Bluesky’s own best was an image post of 4 November at 15,604 likes, 1,245 reposts and 399 quotes.

## Inputs

The whole request. Anything you leave out falls back to the default shown in the catalog.

| Input | Type | Required | What it does |
| --- | --- | --- | --- |
| `handle` | string | yes | Bluesky handle (bsky.app, name.bsky.social), DID or profile URL. |
| `include_replies` | boolean | no | Deliver the account's replies to other posts too (default false). |
| `include_reposts` | boolean | no | Deliver the posts the account reposted too (default true). |
| `max_results` | integer | no | How many posts to deliver at most (1–1000). You pay only for delivered posts. |

Outputs — 27 fields, one row per post

## What one post looks like

Every delivered post carries these fields. Nullable means the source did not publish it — the field stays empty instead of being guessed.

| Field | Type | What it holds |
| --- | --- | --- |
| `rank` | integer | 1-based delivery order, newest first. |
| `uri` | string | The post's URI (at://…). |
| `cid` | string · nullable | Content id of this version of the post. |
| `url` | string | Link to the post. |
| `text` | string · nullable | Post text. |
| `created_at` | string · nullable | Posted at (ISO 8601). |
| `indexed_at` | string · nullable | When Bluesky indexed the post (ISO 8601). |
| `langs` | string[] | Languages the author declared. |
| `author_handle` | string | Handle of the post's author (the original author for a repost). |
| `author_name` | string · nullable | Author display name. |
| `author_did` | string · nullable | Author DID. |
| `replies` | integer · nullable | Exact reply count. |
| `reposts` | integer · nullable | Exact repost count. |
| `likes` | integer · nullable | Exact like count. |
| `quotes` | integer · nullable | Exact quote count. |
| `bookmarks` | integer · nullable | Bookmark count. |
| `is_repost` | boolean | True when the account reposted someone else's post. |
| `reposted_by` | string · nullable | Handle that reposted it. |
| `is_reply` | boolean | True for a reply. |
| `reply_to_uri` | string · nullable | URI of the post it answers. |
| `embed_type` | string · nullable | What the post carries: images, video, link, quote, quote_with_media. |
| `images` | string[] | Full-size image URLs. |
| `video_url` | string · nullable | Video stream (HLS playlist). |
| `link_url` | string · nullable | URL of the link card. |
| `link_title` | string · nullable | Title of the link card. |
| `quoted_post_uri` | string · nullable | URI of the quoted post. |
| `labels` | string[] | Moderation labels on the post. |

Integration

## One POST, typed rows

Base URL `https://api.quanticdata.io/v1`, Bearer auth, the same key as every other Data API. Endpoint: `POST /v1/scraper/collectors/bluesky_posts/run`.

cURL:

```bash
curl -X POST https://api.quanticdata.io/v1/scraper/collectors/bluesky_posts/run \
  -H "Authorization: Bearer $QD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handle":"bsky.app","max_results":50}'
```

Python:

```python
import requests

r = requests.post(
    "https://api.quanticdata.io/v1/scraper/collectors/bluesky_posts/run",
    headers={"Authorization": f"Bearer {QD_API_KEY}"},
    json={
        "handle": "bsky.app",
        "max_results": 50
    },
    timeout=120,
)
for row in r.json()["payload"]["results"]:
    print(row)
```

Node.js:

```javascript
const res = await fetch(
  "https://api.quanticdata.io/v1/scraper/collectors/bluesky_posts/run",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.QD_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"handle":"bsky.app","max_results":50}),
  },
);
const { payload } = await res.json();
console.table(payload.results);
```

MCP:

```bash
claude mcp add quanticdata \
  -e QUANTICDATA_API_KEY=qd_live_your_key_here \
  -- npx -y quanticdata-mcp

# then, in the chat:
> run the bluesky_posts collector with handle="bsky.app"
```

Example response

POST /v1/scraper/collectors/bluesky_posts/run

```bash
$ curl $QD/bluesky_posts/run \
    -H "Authorization: Bearer $QD_API_KEY" \
    -d '{"handle": "bsky.app", "max_results": 50}'
{ "status": "done", "count": 50,
  "results": [
    {
      "author_handle": "…",
      "text": "…",
      "likes": "…",
      "created_at": "…" } ],
  "cost": 0.0025 }
# 50 posts × $0.00005 · nothing delivered, nothing charged
```

Price

## Limits, in plain numbers

Everything that bounds one run of this collector. No hidden throttles.

Max per run

1000 posts

Price

$0.00005 / post

Per 1,000

$0.05

Failed runs

Free zero rows, zero charge

Free every month

$2 no card

Rate limit

20 req/min on the free tier

Changelog

- `v1.0.0` 2026-11-11 Initial release

  A Bluesky account's posts, 100 per call, exact counts.

Every run records the collector version it ran on. Breaking output changes bump the major version.

Try it

## Bluesky posts, running now

Change the input and run it against the live collector — nothing to install, no sign-up.

Run it from your own code, on your own inputs

Same collector, same rows — $2 of free API credit every month, no card.

[Get my free API key](https://app.quanticdata.io/register?utm_source=collector-page&utm_medium=website&utm_campaign=data-api&utm_content=bluesky-scraper-api-closing)

![Bluesky scraper API: from handle, QuanticData reads the Bluesky feed and returns one row per post with author_handle, text and likes, at $0.00005 per delivered post.](https://quanticdata.io/collectors/bluesky-scraper-api/diagram.webp?v=20261002s)

*You send a Bluesky handle; its posts come back as rows with author_handle, text and likes — 27 fields on every row — and you are billed $0.00005 for each post actually delivered, nothing for a run that delivers none.*

**$0.00005 / post** · 40,000 posts on the free $2 every month

**Semantic input** · handle, include_replies, include_reposts — no URL lists

**Up to 1000** posts per run, pagination handled for you

**27 fields** · one row per post

Pricing

## Bluesky Scraper API pricing

$0.00005 per delivered post. A run that delivers nothing costs nothing, and the $2 monthly allowance covers about 40,000 posts before you spend anything.

**$0.00005** per delivered post · *$0.05 per 1,000 delivered posts*

**40,000 posts** · on the free allowance · *$2 every month, no card*

**Zero rows** · zero charge · *a run that delivers nothing is free*

**−30%** on volume tiers · *the catalog returns your key's price*

- [Pay as you go](https://app.quanticdata.io/register?utm_source=collector-page&utm_medium=website&utm_campaign=data-api&utm_content=bluesky-scraper-api-tier-1): $0/mo · $2 free credit / month · 20 requests / min (300 on real balance) · List unit prices
- [Starter](https://app.quanticdata.io/register?utm_source=collector-page&utm_medium=website&utm_campaign=data-api&utm_content=bluesky-scraper-api-tier-2): $19/mo · $15 free credit / month · 300 requests / min · 10% off unit prices
- [Growth](https://app.quanticdata.io/register?utm_source=collector-page&utm_medium=website&utm_campaign=data-api&utm_content=bluesky-scraper-api-tier-3): Most popular · $79/mo · $50 free credit / month · 600 requests / min · 20% off unit prices
- [Scale](https://app.quanticdata.io/register?utm_source=collector-page&utm_medium=website&utm_campaign=data-api&utm_content=bluesky-scraper-api-tier-4): $299/mo · $250 free credit / month · 1,200 requests / min · 30% off unit prices

Same wallet, same key and same $2 monthly allowance as every other [Data API](https://quanticdata.io/web-data-api-for-ai/). Prices are launch pricing read live from the billing config — `GET /v1/scraper/collectors` returns the price your key actually pays.

## What people build with the Bluesky scraper

Three shapes of work this endpoint was designed around.

### Social listening on the accounts that matter

Brands, journalists and researchers who moved to Bluesky, read on a schedule: what they post, what gets engagement, which links they share.

### Datasets for AI and research

Text, declared languages, labels and exact counts per post from an open network, for classifiers and studies, next to the accounts from the [Bluesky profile scraper](https://quanticdata.io/collectors/bluesky-profile-scraper-api/).

### Comparing networks

The same account’s posts on Bluesky and on X with the [Twitter scraper API](https://quanticdata.io/collectors/twitter-scraper-api/): where each message got more replies, reposts and likes.

## Bluesky Scraper API versus rolling your own

The differences that actually cost time when you build this in-house.

|  | DIY scraper | This collector |
| --- | --- | --- |
| Access | An AT Protocol client and your own paging code | One POST with your API key |
| Reposts | Mixed in with the account’s own posts | Flagged, with the original author and who reposted |
| Counts | Nested in each record | Exact likes, reposts, replies, quotes and bookmarks as fields |
| Media | Embed objects to unpack | Image URLs, video stream and link card as fields |
| Volume | A page at a time, cursor by cursor | Up to 1,000 posts in one run |
| Billing | Your servers and your time | Only delivered posts |

![Bluesky scraper API: the POST to the bluesky_posts collector, 50 posts delivered and the bill, 50 × $0.00005 = $0.0025 in usage.cost_usd; zero posts would cost $0.](https://quanticdata.io/collectors/bluesky-scraper-api/diagram2.webp?v=20261002s)

*The same call you would paste into a terminal: a Bearer key, the handle in the body, and back the envelope every QuanticData endpoint returns — type, message, payload — where count is how many posts arrived and usage.cost_usd is $0.0025, which is 50 × $0.00005. A run that delivers nothing costs nothing.*

## Sources and standards

The platform documentation and standards this collector is built against — check any claim on this page against the primary source:

- [Bluesky API: app.bsky.feed.getAuthorFeed](https://docs.bsky.app/docs/api/app-bsky-feed-get-author-feed)
- [Bluesky API directory](https://docs.bsky.app/docs/advanced-guides/api-directory)
- [Bluesky Terms of Service](https://bsky.social/about/support/tos)

## FAQ

Questions we get about the Bluesky scraper.

[Something else? Ask us](https://quanticdata.io/collectors/bluesky-scraper-api/#ask)

### Can I scrape Bluesky without an account?

Yes. Bluesky posts are public, and the collector reads them without logging in and without an app password. You need a QuanticData key; each delivered post costs $0.00005, so 1,000 posts cost $0.05.

### Can I get only the posts an account wrote itself?

Yes. Set `include_reposts` to false and the run leaves reposts out. Replies to other people’s posts are off by default and come in with `include_replies`.

### How many posts can one run return?

Up to 1,000, newest first. For an account that posts a few times a day that is months of history in a single call.

### Is scraping Bluesky legal?

The collector reads only posts that Bluesky serves publicly to anyone without signing in. How you may use them depends on Bluesky’s Terms of Service and on the law where you work, so check both for your use case.

### Is there a free Bluesky scraper?

Every account gets $2 of credit every month with no card, which is about 40,000 delivered posts on this endpoint at $0.00005 each. It renews monthly, and a run that delivers nothing is never billed.

### How much does one run cost?

Multiply the rows you actually receive by $0.00005. A run capped at 1000 posts — the maximum for this collector — costs $0.05 if every row comes back, and less when the listing has fewer. Volume tiers take up to 30% off, and `GET /v1/scraper/collectors` returns the price your key actually pays.

## Run the Bluesky scraper now

$2 of free credit every month, no card. Your key returns its own prices from `GET /v1/scraper/collectors`.

[Get my free API key](https://app.quanticdata.io/register?utm_source=collector-page&utm_medium=website&utm_campaign=data-api&utm_content=bluesky-scraper-api-cta-3)

![Illustration: three coloured zones of the page that is read (Bluesky feed) turn into clean JSON with the fields author_handle, text and likes; 27 fields on every row.](https://quanticdata.io/collectors/bluesky-scraper-api/hero.webp?v=20261003c1)

Related:

- [All 100+ collectors](https://quanticdata.io/collectors/)
- [Bluesky profile scraper API](https://quanticdata.io/collectors/bluesky-profile-scraper-api/)
- [Twitter (X) scraper API](https://quanticdata.io/collectors/twitter-scraper-api/)
- [Reddit scraper API](https://quanticdata.io/collectors/reddit-scraper-api/)
- [Documentation](https://quanticdata.io/docs/)

---

Source: https://quanticdata.io/collectors/bluesky-scraper-api/ · Site index for AI: https://quanticdata.io/llms.txt
