100 free credits — no credit card required.Start building
Logo
100 free credits — no credit card required

Bluesky Scraper API

Bluesky API: 3 endpoints for profiles, user post feeds, and post details with threaded replies. Every call costs 1 credit, and new accounts start with 100 free credits — no credit card. Plain REST with one x-api-key: no AT Protocol sessions, XRPC lexicons, DIDs, or app passwords to manage.

TL;DR

The Bluesky API by SocialCrawl returns Bluesky data as structured JSON — 3 endpoints behind one x-api-key, from 1 credit per call. It shares one unified schema with 43 other platforms, so the same client code works everywhere.

Live demo

Try the Bluesky API in your browser

Type a real handle, run a real request, see the JSON SocialCrawl returns. No signup, no key — same response shape you get in production.

Try the Bluesky Profile API

See real data before writing a single line

GET/v1/bluesky/profile

Bluesky handle (e.g. `espn.com`).

Endpoints

What data does the Bluesky API return?

Every endpoint returns structured JSON with a unified schema. Computed fields like engagement rate and content category come standard.

Last updated July 2026

Maintained by the SocialCrawl team, reviewed July 2026

Profilestandard

Get a Bluesky profile

User Postsstandard

List a Bluesky user's posts

Poststandard

Get a Bluesky post

What you get

What Bluesky data can you get?

Every Bluesky endpoint returns the same unified JSON schema, so one parser handles the whole platform. These are the real fields the Bluesky API returns, taken straight from live responses.

Fields you get back in a Bluesky response include:

  • id
  • username
  • display_name
  • avatar_url
  • bio
  • verified
  • followers
  • following
  • posts_count
  • likes_count
  • url
  • private
  • joined_at
  • computed.engagement_rate
  • computed.language
  • computed.content_category
  • computed.estimated_reach
  • post.id
  • post.url
  • post.content
  • post.author
  • post.engagement
  • post.flags
  • post.published_at
Quickstart

How to scrape Bluesky in 3 steps

No proxies, no headless browsers, no login sessions. Send one authenticated GET request and read structured JSON back.

  1. 1

    Get a free API key

    Create an account and copy your key from the dashboard. Signup includes 100 free credits, and no card is required.

  2. 2

    Call the Profile endpoint

    Send a GET request with your key in the x-api-key header. Here is the full Bluesky Profile request:

    curl -H "x-api-key: YOUR_API_KEY" \
      "https://www.socialcrawl.dev/v1/bluesky/profile?handle=espn.com"
  3. 3

    Read the unified JSON

    The response comes back in the shared SocialCrawl schema, with computed fields like engagement_rate and content_category already filled in, so the same client code works across every platform.

Requirements and limits

Requirements and limits

Everything you need to know before your first Bluesky call.

Authentication
One API key, passed in the x-api-key request header. No OAuth flow, no app review, and no per-platform credentials to manage.
Pagination
List endpoints return a next_cursor and a has_more flag. Pass the cursor back to page through results, with the same contract on every platform.
Credits
Calls start at 1 credits and are deducted per request. Every account starts with 100 free credits, and credits never expire.
Rate limits
There are no artificial rate limits. Your credit balance is the only throttle, so you can run requests concurrently as fast as you need.
Pricing

How much does the Bluesky API cost?

Simple credit-based pricing with no subscription. You pay per call, and the exact credit cost of every Bluesky endpoint is listed below.

EndpointCredits per call
Profile1 credit
User Posts1 credit
Post1 credit

Every account starts with 100 free credits, and no card is required.

At credit-pack pricing that works out to roughly £0.002 to £0.006 per call, and credits never expire.

Developer First

How do you scrape social media data in seconds?

The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 44 platforms covering 10B+ monthly active users.

One schema, every platform

Query 44 platforms with identical response structures. Write your integration once.

Computed fields, not just scraped

Every response includes engagement_rate, estimated_reach, content_category, and language — ready to use.

See your data before you code

Visual Data Explorer — paste any URL, get rich result cards, sortable tables, CSV export.

import requests

response = requests.get(
    'https://www.socialcrawl.dev/v1/tiktok/profile',
    params={'handle': 'charlidamelio'},
    headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()
[ .JSON ]
{
  "success": true,
  "platform": "tiktok",
  "data": {
    "author": {
      "username": "charlidamelio",
      "followers": 152400000
    },
    "engagement": {
      "likes": 12400000000,
      "engagement_rate": 0.087
    },
    "metadata": {
      "language": "en",
      "content_category": "lifestyle"
    }
  }
}
+ 44 platforms
One API, 44 platforms

How does SocialCrawl handle 44 different platforms?

Social media scraping is hard. Schema normalization, authentication, rate limits, pagination — we handle it all before your data arrives.

One schema, every platform

Write once, query them all.

44 platforms return 44 different JSON shapes. We normalize every response into one consistent structure.

Ready-to-use metrics

Metrics ready before you ask.

Engagement rate, estimated reach, content category, language — calculated on every response automatically.

Consistent pagination

One cursor, every platform.

Every platform paginates differently. We give you one consistent cursor-based system.

Always fresh

Live data, never cached.

Every request hits the actual platform. No stale data, no cache lag.

Things you'll never build

Auth, proxies, and rate limits — handled.

Platform authentication, IP rotation, rate limit management — abstracted away. Just send a GET request.

Start for free
Reviews

What developers say

Rated 4.9 out of 5 from 200 developer reviews
The unified schema saved us weeks of integration work. One parser handles every platform.
Alex Chen, Full-Stack Developer
Our agents process social data from 44 platforms with zero platform-specific logic — one schema, end to end.
Sarah Kim, AI Engineer, AgentFlow
I paste an influencer's URL and get everything — followers, engagement rate, content categories — without touching code.
James Rivera, Marketing Director
We switched from building our own scrapers. SocialCrawl handles the hard stuff, we focus on insights.
Maria Santos, CTO, DataPulse
The computed fields alone — engagement_rate, estimated_reach, content_category — saved us an entire data pipeline.
David Park, Lead Data Scientist
Comparison

How does SocialCrawl compare to AT Protocol (direct) for Bluesky data?

Same Bluesky data, two very different paths. Auth, rate limits, schema, and cost — side by side.

Authentication

SocialCrawl
One x-api-key header
AT Protocol (direct)
Session-based auth with app passwords or OAuth

Setup / approval

SocialCrawl
Sign up and call immediately
AT Protocol (direct)
No approval queue, but you build an XRPC client with lexicons and DIDs

Rate limits

SocialCrawl
Credit-based — pay per request
AT Protocol (direct)
Per-account and per-IP limits you manage yourself

Response schema

SocialCrawl
Unified JSON shared across 44 platforms
AT Protocol (direct)
AT Protocol records with lexicon-specific shapes

Pricing

SocialCrawl
1 credit per request; 100 free credits on signup
AT Protocol (direct)
Free — you pay in engineering and infrastructure time

Data coverage

SocialCrawl
Profiles, post feeds, and reply threads — read-only
AT Protocol (direct)
Full network access including posting, firehose streams, and custom feeds

Maintenance

SocialCrawl
Schema stays stable when Bluesky changes internals
AT Protocol (direct)
You track lexicon and protocol evolution
Quick answers

How much does Bluesky scraping cost?

SocialCrawl uses credit-based pricing: you pay per API call, and most Bluesky endpoints cost just a few credits. Every account starts with 100 free credits — no subscriptions, no compute units, no credit card required.

See pricing

Is Bluesky scraping legal?

SocialCrawl returns publicly available Bluesky data. Courts have generally upheld scraping public data — most notably in hiQ v. LinkedIn — but compliance depends on your use case and jurisdiction. You are responsible for following applicable laws and platform terms.

Glossary

Common Bluesky scraping terms

The phrases developers search for when they need Bluesky data, and what each one means with SocialCrawl.

Bluesky scraper API
A Bluesky scraper API returns Bluesky data as structured JSON without you running any scraping infrastructure. SocialCrawl handles the proxies, parsing, and format changes, so you call an endpoint and get clean fields back. Pricing starts at 1 credits per call.
Bluesky data API
A Bluesky data API is a programmatic way to read public Bluesky data on demand. SocialCrawl exposes 3 Bluesky endpoints behind one x-api-key, all sharing the same unified schema, so your integration never has to change per platform.
scrape Bluesky
To scrape Bluesky is to extract its public data programmatically instead of by hand. With SocialCrawl you scrape Bluesky by sending a single authenticated request, and the response is normalised into the same JSON shape used across every platform.
Read the full API reference
FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

Contact us
How do I scrape Bluesky data with an API?
SocialCrawl exposes 3 Bluesky endpoints — profile, user posts, and post details with threaded replies. Send a GET request with your x-api-key and a handle or post URL; you get normalized JSON back with no AT Protocol session, no XRPC client, and no app password.
Is there a Bluesky data API?
Yes. SocialCrawl is a Bluesky data API that returns profiles, user post feeds, and posts with threaded replies as unified JSON from a single GET. Bluesky runs on the open AT Protocol, so the official route is fully capable: it lets you post, stream the firehose, and run custom feeds, but it means building an XRPC client with lexicons, DIDs, and session auth. When you only need to read public data, SocialCrawl skips that with one x-api-key across 3 REST endpoints, and 100 free credits to start.
Do I need an AT Protocol client or Bluesky app password?
No. The official Bluesky API speaks XRPC with lexicons, DIDs, and session-based auth. SocialCrawl wraps all of that behind plain REST: one x-api-key header, standard GET requests, and the same response envelope used across the other 40+ platforms we support.
What Bluesky endpoints does SocialCrawl offer?
3 endpoints: Profile, User Posts, and Post. All return the unified SocialCrawl schema.
How is this different from the Bluesky firehose?
The Bluesky firehose streams every event on the network — you filter, decode CBOR, and maintain consumers yourself. SocialCrawl is request-based: ask for one profile, feed, or post and get clean JSON in a single GET. For monitoring specific accounts or posts, request-based is far less infrastructure.
How much does the Bluesky API cost?
Each Bluesky request costs 1 credit on the standard tier. New accounts get 100 free credits with no credit card required — enough to test all 3 endpoints end-to-end before you pay anything.
Is scraping Bluesky data legal?
SocialCrawl reads only publicly visible Bluesky data — public profiles, public posts, and public replies. You are responsible for complying with Bluesky's Terms of Service and any data protection regulations that apply to your use case, especially for research datasets. SocialCrawl operates under a documented GDPR legitimate-interest framework: public, logged-out data only, no credential use, short-lived caches (2 to 30 minutes) with no persistent store, and a public opt-out channel for anyone whose public info appears in responses. Full details: socialcrawl.dev/legal/public-data-notice.
What is the best Bluesky scraper API?
For reading public Bluesky data without building an AT Protocol client, SocialCrawl is the simplest option: 3 REST endpoints for profiles, user post feeds, and posts with threaded replies, each costing 1 credit. New accounts get 100 free credits with no credit card — no XRPC, lexicons, DIDs, or app passwords.
Bluesky scraping API vs the official Bluesky API — what's the difference?
With SocialCrawl there is no app review or approval queue — sign up and call Bluesky endpoints immediately with a single x-api-key. Responses share one unified schema with every other SocialCrawl platform, and credit-based pricing replaces per-platform quotas. Official APIs are still the right choice for posting and other write actions: SocialCrawl is read-only data.

Ask AI about SocialCrawl

Ready to start scraping Bluesky data?

Get your API key and access all 3 Bluesky endpoints in under 60 seconds.

Start for free

🤖 AI agent or LLM? Read this page as markdown