InsightSocial

Bluesky scraper API

The InsightSocial Bluesky API has 4 endpoints, from 10 credits a call. A profile call costs 10 credits, about $0.01 on Pro, and your first 10 calls up to 100 credits each are free.

The Bluesky API for public profiles, posts, reply threads and keyword search, as JSON in the same schema as every other platform on your key. Search included, with no Bluesky account or app password.

4 endpoints · from 10 credits a call · 10 free calls up to 100 credits each · no credit card

curl "https://api.insightsocial.app/v1/bluesky/profile?handle=examplecreator.bsky.social" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
200 OKJSON
{
"success": true,
"platform": "bluesky",
"endpoint": "/v1/bluesky/profile",
"schema_version": "2",
"data": {
"author": {
"id": "did:plc:exampleexample000000000000",
"username": "examplecreator.bsky.social",
"display_name": "Example Creator",
"avatar_url": "https://cdn.example.com/avatars/examplecreator.jpg",
"bio": "Field notes on city birds. Newsletter at example.com",
"verified": false,
"followers": 18450,
"followers_approximate": null,
"following": 391,
"posts_count": 2264,
"likes_count": null,
"url": "https://bsky.app/profile/examplecreator.bsky.social",
"location": null,
"external_url": null,
"private": null,
"joined_at": "2023-05-14T09:21:07.000Z",
"last_post_at": null,
"ext": null
}
},
"unavailable": [],
"credits_used": 0,
"charge_reason": "miss",
"free_call": true
}

What Bluesky data can you get?

Public Bluesky data only, returned in the same JSON envelope as every other platform.

Profiles

Handle, display name, bio, follower, following and post counts, account creation date and verification.

Posts and reply threads

An account's posts with reply, repost, like and quote counts, and one post in full with its threaded replies.

Keyword search

Posts across Bluesky by keyword, up to 100 a page, filtered by date range, language or author and sorted by latest or top.

Bluesky API endpoints

All 4 Bluesky endpoints and their price in credits. Every one has a fixed price.

EndpointCreditsWhat it returns
/profile10Returns a Bluesky user's public profile: handle, display name, avatar, description, follower and follows counts, post count, created date, and verification status.
/user/posts10Returns a feed of posts for a Bluesky user: text, author info, embeds, reply/repost/like/quote counts, and when each was indexed.
/post10Returns one Bluesky post: its record text, author info, embeds, reply count, repost count, like count, quote count, and a threaded replies array.
/search10Returns Bluesky posts matching a keyword, up to 100 per page, each with its text, author, like/comment/share counts, and when it was written.

Parameters, response fields and examples for each endpoint are in the Bluesky API reference.

InsightSocial vs the official Bluesky API

Bluesky's own AppView API is open: profiles, feeds and post threads can be read at public.api.bsky.app without a key. Post search is the exception, and needs a signed-in account.

InsightSocial APIOfficial Bluesky API
AccessSign in and copy a keyOpen: no key for public reads
Keyword searchIncluded, by date, language or authorNeeds a signed-in Bluesky account
Response formatSchema 2, the same as 60 other platformsAT Protocol records
Cost per call10 creditsFree for public reads

The official API is the right tool for posting, messaging or managing accounts you own. This one is read-only public data.

How much does the Bluesky API cost?

Bluesky calls start at 10 credits. Every endpoint's price is in the table above and in the free GET /v1/endpoints catalogue, so you know the cost before you call. Pro's 10,000 monthly credits cover about 1,000 profiles at 10 credits each.

  • Failed calls are free

    A call that errors or finds nothing costs 0 credits.

  • Repeats and retries

    A repeat call is charged again: the full price when it fetches new data, 2 credits when the answer comes from the shared cache. Add fresh=1 to force a new read. Only a retry with the same Idempotency-Key is free.

  • One balance

    API calls and Chrome extension exports share the same credits. The free plan includes 500 a month.

Not writing code?

Connect InsightSocial to Claude or ChatGPT and ask for Bluesky data in plain English. Same account, same credits.

Use it from Claude or ChatGPT

Bluesky API: frequently asked questions

Yes. Bluesky's public AppView API reads profiles, feeds and post threads with no key, and for a Bluesky-only project it is often the simplest choice. The InsightSocial API is for when Bluesky is one source among several: the same key, envelope and field names as 60 other platforms, and keyword search without a Bluesky account.