Documentation Python quickstart Blog Free tools Enterprise solutions hello@quanticdata.ioLog in
All collectors

Bluesky profile scraper API

Social & communities · v1.0.0 · bluesky_profile

$0.001 / profile

$1.00 / 1K · pay per delivered profile

A Bluesky profile scraper API: send handles, DIDs or profile URLs and get one row per account with the exact follower, following and post counts, the bio, avatar and banner, the join date, the verification marks and the moderation labels. No login and no app password, billed per profile delivered.

$0.001 per delivered profile · $2 free every month · Failed runs never billed

What it does

What a Bluesky profile scraper returns

Every Bluesky account has two names: the handle people see, which can be a domain such as nytimes.com, and a DID that stays the same when the handle changes. The collector returns both on every row, so a list you keep for months still joins up after an account renames itself, with the counts as exact numbers and the dates in ISO 8601.

On 13 November 2026 the bsky.app account had 35,644,820 followers and 921 posts. It carries no verification mark of its own but is a trusted verifier, the role Bluesky gives to accounts that can verify others. The New York Times had 1,357,970 followers and 45,353 posts, and is both. Those are two fields, verified and trusted_verifier, so a list filters by either.

Inputs

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

InputTypeRequiredWhat it does
handlesstring[]yesBluesky handles (bsky.app, name.bsky.social), DIDs or profile URLs, one per line, up to 200.
max_resultsintegernoHow many profiles to deliver at most (1–200). You pay only for delivered profiles.

Outputs — 17 fields, one row per profile

What one profile looks like

Every delivered profile 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.
handlestringHandle.
didstringThe account's permanent id (DID).
display_namestring · nullableDisplay name.
descriptionstring · nullableProfile bio.
avatarstring · nullableAvatar URL.
bannerstring · nullableBanner image URL.
followersinteger · nullableExact follower count.
followinginteger · nullableAccounts followed.
postsinteger · nullablePosts published.
created_atstring · nullableAccount creation time (ISO 8601).
indexed_atstring · nullableWhen Bluesky last indexed the profile (ISO 8601).
verifiedbooleanTrue when the account carries Bluesky's verification mark.
trusted_verifierbooleanTrue when the account is itself a trusted verifier.
labelsstring[]Moderation labels on the account.
pinned_post_uristring · nullableURI of the pinned post.
urlstringProfile URL.

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_profile/run.

curl -X POST https://api.quanticdata.io/v1/scraper/collectors/bluesky_profile/run \
  -H "Authorization: Bearer $QD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handles":["bsky.app","nytimes.com"],"max_results":2}'

Example response

POST /v1/scraper/collectors/bluesky_profile/run
$ curl $QD/bluesky_profile/run \
    -H "Authorization: Bearer $QD_API_KEY" \
    -d '{"handles": ["bsky.app", "nytimes.com"], "max_results": 2}'
{ "status": "done", "count": 2,
  "results": [
    {
      "handle": "…",
      "followers": "…",
      "posts": "…",
      "created_at": "…" } ],
  "cost": 0.002 }
# 2 profiles × $0.001 · nothing delivered, nothing charged

Try it

Bluesky profiles, 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 profile scraper API: from handles, QuanticData reads the Bluesky profile and returns one row per profile with handle, followers and verified, at $0.001 per delivered profile.
You send Bluesky handles; each comes back as one row with handle, followers and verified — 17 fields on every row — and you are billed $0.001 for each profile actually delivered, nothing for a run that delivers none.
$0.001 / profile2,000 profiles on the free $2 every month
Semantic inputhandles, max_results — no URL lists
Up to 200profiles per run, pagination handled for you
17 fieldsone row per profile

Pricing

Bluesky Profile Scraper pricing

$0.001 per delivered profile. A run that delivers nothing costs nothing, and the $2 monthly allowance covers about 2,000 profiles before you spend anything.

$0.001per delivered profile$1.00 per 1,000 delivered profiles
2,000 profileson 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 profile scraper

Three shapes of work this endpoint was designed around.

Creator and newsroom tracking

Follower and post counts for the accounts you follow, read on a schedule: growth after a move from X, which outlets publish the most, who got verified this month.

A clean account list for research

Handles from a starter pack, a search or a spreadsheet become rows keyed by DID, with bio and join date, before you read their posts with the Bluesky scraper API.

One audience table across networks

The same brand’s Bluesky row next to its X profile and its Instagram profile: followers and posts side by side.

Bluesky Profile Scraper 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 code around itOne POST with your API key
BatchYour own loop over the handlesUp to 200 handles in one run
IdentityHandles that can changeHandle and permanent DID on every row
VerificationBadges in the appverified and trusted_verifier as fields
OutputNested JSON recordsFlat rows with exact counts and ISO dates
BillingYour servers and your timeOnly delivered profiles
Bluesky profile scraper API: the POST to the bluesky_profile collector, 2 profiles delivered and the bill, 2 × $0.001 = $0.002 in usage.cost_usd; zero profiles would cost $0.
The same call you would paste into a terminal: a Bearer key, the handles in the body, and back the envelope every QuanticData endpoint returns — type, message, payload — where count is how many profiles arrived and usage.cost_usd is $0.002, which is 2 × $0.001. 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 profile scraper.

Something else? Ask us

Do I need a Bluesky account to scrape profiles?

No. Bluesky profiles are public, and the collector reads them without logging in and without an app password. You need a QuanticData API key, and each delivered profile costs $0.001.

Can I look up a profile by DID instead of handle?

Yes. Send a handle (bsky.app, name.bsky.social), a DID (did:plc:…) or a profile URL. Every row returns both the current handle and the DID, which stays the same when the account changes its handle.

What is a trusted verifier on Bluesky?

An account Bluesky lets verify other accounts, such as a newsroom verifying its journalists. The row says so in trusted_verifier, separately from verified, which is the mark on the account itself.

Is scraping Bluesky legal?

The collector reads only public profile data that Bluesky serves to anyone without signing in. How you may use it 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 profile scraper?

Every account gets $2 of credit every month with no card, which is about 2,000 delivered profiles on this endpoint at $0.001 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.001. A run capped at 200 profiles — the maximum for this collector — costs $0.20 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 profile 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 profile) turn into clean JSON with the fields handle, followers and verified; 17 fields on every row.