Documentation Python quickstart Blog Free tools Enterprise solutions hello@quanticdata.ioLog in
All 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.

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

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.

InputTypeRequiredWhat it does
handlestringyesBluesky handle (bsky.app, name.bsky.social), DID or profile URL.
include_repliesbooleannoDeliver the account's replies to other posts too (default false).
include_repostsbooleannoDeliver the posts the account reposted too (default true).
max_resultsintegernoHow 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.

FieldTypeWhat it holds
rankinteger1-based delivery order, newest first.
uristringThe post's URI (at://…).
cidstring · nullableContent id of this version of the post.
urlstringLink to the post.
textstring · nullablePost text.
created_atstring · nullablePosted at (ISO 8601).
indexed_atstring · nullableWhen Bluesky indexed the post (ISO 8601).
langsstring[]Languages the author declared.
author_handlestringHandle of the post's author (the original author for a repost).
author_namestring · nullableAuthor display name.
author_didstring · nullableAuthor DID.
repliesinteger · nullableExact reply count.
repostsinteger · nullableExact repost count.
likesinteger · nullableExact like count.
quotesinteger · nullableExact quote count.
bookmarksinteger · nullableBookmark count.
is_repostbooleanTrue when the account reposted someone else's post.
reposted_bystring · nullableHandle that reposted it.
is_replybooleanTrue for a reply.
reply_to_uristring · nullableURI of the post it answers.
embed_typestring · nullableWhat the post carries: images, video, link, quote, quote_with_media.
imagesstring[]Full-size image URLs.
video_urlstring · nullableVideo stream (HLS playlist).
link_urlstring · nullableURL of the link card.
link_titlestring · nullableTitle of the link card.
quoted_post_uristring · nullableURI of the quoted post.
labelsstring[]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 -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}'

Example response

POST /v1/scraper/collectors/bluesky_posts/run
$ 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

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
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.
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 / post40,000 posts on the free $2 every month
Semantic inputhandle, include_replies, include_reposts — no URL lists
Up to 1000posts per run, pagination handled for you
27 fieldsone 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.00005per delivered post$0.05 per 1,000 delivered posts
40,000 postson the free allowance$2 every month, no card
Zero rowszero chargea run that delivers nothing is free
−30%on volume tiersthe catalog returns your key's price

Same wallet, same key and same $2 monthly allowance as every other Data API. 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.

Comparing networks

The same account’s posts on Bluesky and on X with the 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 scraperThis collector
AccessAn AT Protocol client and your own paging codeOne POST with your API key
RepostsMixed in with the account’s own postsFlagged, with the original author and who reposted
CountsNested in each recordExact likes, reposts, replies, quotes and bookmarks as fields
MediaEmbed objects to unpackImage URLs, video stream and link card as fields
VolumeA page at a time, cursor by cursorUp to 1,000 posts in one run
BillingYour servers and your timeOnly 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.
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:

FAQ

Questions we get about the Bluesky scraper.

Something else? Ask us

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