Bluesky API

Bluesky Scraper API for Profiles and Posts

Read profiles and selected posts in batches, follow paginated account feeds and retrieve post conversations with author details, media metadata and engagement counts.

WHAT YOU CAN BUILD / 05 ENDPOINTS

Put Bluesky data to work.

Find your use case, then explore the request and response.

Get a Bluesky profile

GET/v1/bluesky/profile

Build a creator directory from public profile names, bios, avatars and follower, following and post counts.

Get a Bluesky user’s posts

GET/v1/bluesky/user/posts

Build an account research feed from a user’s posts, text, media and engagement information.

Get a Bluesky post

GET/v1/bluesky/post

Build a post preview or discussion research record from a Bluesky post URL and its associated content.

Get Bluesky profiles in a batch

POST/v1/bluesky/profiles/batch

Enrich a creator shortlist in batches by retrieving public profile details for several accounts in one request.

Get Bluesky posts in a batch

POST/v1/bluesky/posts/batch

Build a comparison sheet from a batch of Bluesky posts, keeping each post’s content and engagement together.

HOW IT WORKS

From API key to Bluesky data in four steps.

Run a sample below without a key.

  1. 01

    Get your API key

    Create a free account and copy your key. You start with 100 free credits; no card needed.

  2. 02

    Choose an endpoint

    Pick one of the 5 Bluesky endpoints and add its input, such as a public handle.

  3. 03

    Send one request

    Call it with your key in the x-api-key header. ScrapeAtlas reads the public Bluesky data and retries when a read fails.

  4. 04

    Use the JSON

    Get structured JSON with a coverage status. Only successful requests use a credit.

TRY IT HERE / LIVE SAMPLE

Try a sample request.

Try the Bluesky API right here. This sample uses the Get a Bluesky profile endpoint and returns live JSON. No API key needed.

  1. 01
    Choose a sample value

    Start with nytimes.com, or change the handle field to your own value.

  2. 02
    Select Run sample

    Execute the sample code and see the response in the JSON response tab.

  3. 03
    Build on the result

    Open the full playground to try more parameters and copy code for your app.

Open this endpoint in the playground Request and response fields
LIVE SAMPLE / Get a Bluesky profileNo API key needed

Preparing the sample…

// Run this sample here — no API key needed.
const value = "nytimes.com";
const url = new URL("/website/demo/bluesky",
  "https://api.scrapeatlas.com");
url.searchParams.set("value", value);

const response = await fetch(url);
const data = await response.json();
console.log(data);
GET/v1/bluesky/profile

A live example from our playground. Change the value above, then select Run sample.

CUSTOMER STORIES

What they are saying
about us.

Nigel Yong — Founder, PostOnce

Pay as you go

Start free.
Build at your pace.

One-time credit packs, priced in US dollars. Credits never expire, and there is no monthly commitment.

Free

Try the API with your next idea.

$0No credit card needed

100 free credits

One starter grant per account

Starter

For a new idea or a one-off project.

$19USD / one-time

10,000 credits

$1.90 per 1,000 successful requests

Growth

Save 6.3%

For regular workflows and bigger builds.

$89USD / one-time

50,000 credits

$1.78 per 1,000 successful requests

Enterprise Plan

Want to scrape larger volumes?

Let’s talk about a plan that fits your scale.

Bluesky API

Frequently Asked Questions

Explore the API reference

Bluesky API and scraping

What public data can I retrieve with the Bluesky API?

Retrieve profile identity, biographies, images and follower counts, account feeds, individual posts and nested replies. Batch endpoints let your application retrieve several profiles or selected post views in one request.

How do I scrape Bluesky posts from a public account?

Pass a handle or user ID to User Posts to retrieve posts, replies and reposts with media and engagement counts. Use the returned cursor to request another page, or look up a particular post by its Bluesky URL.

Can I retrieve a single Bluesky post from its public URL?

Pass the post URL to Post Details to retrieve the author, text, media and conversation data in one response. Use the post identity and source link to connect the record to a saved research entry.

Bluesky: profiles, posts and conversations

Can the Bluesky API retrieve multiple creator profiles at once?

Yes. Profiles Batch accepts handles or DIDs and returns profile metadata with a result for each requested actor in input order. Use the identity, biography and audience counts to enrich a creator shortlist.

Can I get Bluesky post replies and engagement data?

Yes. The individual Post endpoint returns the post, author, media metadata, engagement counts and nested replies. Posts Batch retrieves selected post views by their canonical AT URIs for side-by-side content research.

Which Bluesky engagement counts can I use in a post comparison?

Post Details returns engagement counts alongside the post and author. Posts Batch lets you retrieve selected AT URIs together, so your application can compare the returned counters across a defined set of posts.

API access and integration

How do I get a ScrapeAtlas API key and authenticate requests?

Create a ScrapeAtlas account and generate an API key in the dashboard. Send the key in the x-api-key request header when calling https://api.scrapeatlas.com. The API playground lets you enter an endpoint’s parameters and inspect its JSON response.

Can I call the scraping API from Python, JavaScript or the CLI?

Yes. Send authenticated HTTP requests from Python, JavaScript or another language that supports HTTP. The endpoint reference includes request examples and response fields. Use the ScrapeAtlas CLI for terminal workflows and pass the returned pagination values when requesting additional result pages.

Can I connect an AI assistant to the ScrapeAtlas MCP server?

Yes. Connect an MCP-compatible assistant to the ScrapeAtlas MCP server to discover and call the public platform tools with your ScrapeAtlas account. The agent reference also gives coding assistants a readable guide to the endpoints and their request schemas.

Make something with it

Ready to build?

Bring social data into your next project.
Start with 100 free credits and see what you can build.

No credit card needed.Building with an AI agent?