↑ ↓ to move ↵ to open
Social & content · REST API · MCP server

Bluesky Scraper API

Get public Bluesky profiles, posts, threads, followers, likes, feeds and trending topics as clean JSON. Send a handle, a post link or a feed. No Bluesky account or app password.

  • 1 credit per call
  • Failed calls are free
  • Updated
bluesky.actor.get_profile completed
display_namestringBluesky
handlestringbsky.app
followers_countinteger35,154,398
follows_countinteger15
posts_countinteger865
descriptionstringofficial Bluesky account (check username👆) Bugs, feature reques…
didstringdid:plc:z72i7hdynmk6r22z27h6tvur
indexed_atstring2025-10-27T21:05:26.152Z
Endpoints

Bluesky API endpoints

What each one takes and what it returns. Open one for a real response, every input and every field.

Bluesky Profile API

Get a profile from its handle, DID or bsky.app link: name, bio, followers, follows and post count.

Sendactor Returnsdisplay_namehandlefollowers_countfollows_countposts_countdescription
1 credit

Bluesky Author Feed API

List an account's posts and reposts, newest first, with text, author, language and time, page by page.

Sendactor Returnstextauthorcreated_atlanguri
1 credit

Bluesky Post Thread API

Get a post with its replies, nested a few levels deep, and the post it answers.

Senduri Returnsdepth_requesteddepth_usedthread
1 credit

Bluesky Actors Search API

Find accounts by keyword, page by page.

Sendquery Returnsdisplay_namehandledidindexed_at
1 credit

Bluesky Followers API

List an account's followers, page by page.

Sendactor ReturnsJSON; every field is in the API reference
1 credit

Bluesky Follows API

List the accounts an account follows, page by page.

Sendactor ReturnsJSON; every field is in the API reference
1 credit

Bluesky Post Likes API

List the accounts that liked a post.

Senduri ReturnsJSON; every field is in the API reference
1 credit

Bluesky Repost Users API

List the accounts that reposted a post.

Senduri ReturnsJSON; every field is in the API reference
1 credit

Bluesky Trending Topics API

Get the topics trending on Bluesky now: title, summary, category and how many posts each has.

Returnsdisplay_namedescriptioncategorypost_countstarted_atfeed_uri
1 credit

Bluesky Feed Generators API

Discover the popular custom feeds people use on Bluesky, with their likes.

Returnsdisplay_namedescriptionlike_counturididindexed_at
1 credit

Bluesky Feed Posts API

Read the posts in any public custom feed, page by page.

Sendfeed ReturnsJSON; every field is in the API reference
1 credit
Use cases

What teams build with Bluesky data

Know before you build

How Bluesky data behaves

REST API · MCP server

Call it from your code, or ask your agent

One request shape for every Bluesky endpoint: the endpoint ID and its input. No SDK needed.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "bluesky.actor.get_profile",  "input": {    "actor": "bsky.app"  }}'
Response
{  "display_name": "Bluesky",  "handle": "bsky.app",  "description": "official Bluesky account (check username👆)\n\nBugs, feature requests, feedback: [email protected]",  "did": "did:plc:z72i7hdynmk6r22z27h6tvur",  "followers_count": 35154398,  "follows_count": 15,  "indexed_at": "2025-10-27T21:05:26.152Z",  "posts_count": 865}
In your AI agent Claude · Cursor · any MCP client
1Add the Upscrape MCP server
https://data.upscrape.com/mcp
2Ask for the data in plain words

Use Upscrape to look up @bsky.app on Bluesky. How many followers and posts does it have?

With Upscrape, get the latest posts from @bsky.app and summarise what Bluesky announced recently, with links.

Using Upscrape, list the topics trending on Bluesky right now with their category and post count, biggest first.

The agent finds the endpoint, shows you the price, and runs it with your credits.
Social & content
Questions

Bluesky Scraper API FAQ

The short answers. The docs have the long ones.

Still have a question? Talk to the people who build the endpoints.
Bluesky has an open API. Why use Upscrape?

You can call Bluesky's public API yourself. Upscrape gives you the same public data as clean JSON in the same shape as every other platform Upscrape covers, with paging handled, over REST or MCP, so one integration covers them all.

Do I need a Bluesky account?

No. You send a handle, a link or a feed and get JSON back. No account or app password is needed.

Can I search posts by keyword?

Not yet. You can search accounts, read any account's posts and threads, and follow feeds and trending topics.

What data can I get from Bluesky?

Profile, author feed, post thread, actors search, followers, follows, post likes, repost users, trending topics, feed generators, feed posts and resolve handle. Each is its own endpoint with a published input schema, and the response is JSON.

How much does the Bluesky API cost?

Every Bluesky endpoint costs 1 credit per successful call. You buy credits once, with no subscription, and paid credits never expire. New accounts get free credits to try it.

Can an AI agent use the Bluesky API?

Yes. Connect any MCP client to the Upscrape MCP server with OAuth or an API key. The agent finds the Bluesky endpoint, checks its price and runs it with the same credits as the REST API.

Is it legal to scrape Bluesky?

Upscrape reads public pages only and needs no login. How you use the data is yours to decide under the laws that apply to you; we sign a data processing agreement for your legal review.

What happens when Bluesky changes its pages?

We fix the endpoint. Your request and the response fields stay the same.

Get started

Your first Bluesky call is free.

Up to 100 free credits to start, no card needed.