APIs / Social media / Bluesky

1 credit per call15 endpoints

Bluesky API

Get Bluesky data as structured JSON with one API key: search posts, search users, followers and following. Free credits every month.

Bluesky
GET/v1/bluesky/search-users?q=nasa&limit=10
curl "https://api.perceptlayer.com/v1/bluesky/search-users?q=nasa&limit=10" \
  -H "X-API-Key: $API_KEY"
cURL1 credit per successful call
Run this call below or from your dashboard to see a live response.

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/bluesky/search-users?q=nasa&limit=10" \
  -H "X-API-Key: $API_KEY"

Bluesky · 15 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

Note
Endpoints marked “Needs terms” return personal or social data. They work once you accept the restricted-endpoint terms in your dashboard.
EndpointRequired parametersCost
GET/v1/bluesky/followers
actor+3 optionalNeeds terms
1 credit
GET/v1/bluesky/following
actor+3 optionalNeeds terms
1 credit
GET/v1/bluesky/likes
uri+2 optionalNeeds terms
1 credit
GET/v1/bluesky/posts
None+1 optionalNeeds terms
1 credit
GET/v1/bluesky/profile
actorNeeds terms
1 credit
GET/v1/bluesky/profiles
None+1 optionalNeeds terms
1 credit
GET/v1/bluesky/quotes
uri+2 optionalNeeds terms
1 credit
GET/v1/bluesky/relationships
NoneNeeds terms
1 credit
GET/v1/bluesky/reposts
uri+2 optionalNeeds terms
1 credit
GET/v1/bluesky/resolve-handle
handleNeeds terms
1 credit
GET/v1/bluesky/search-posts
version+32 optionalNeeds terms
1 credit
GET/v1/bluesky/search-users
q+2 optionalNeeds terms
1 credit
GET/v1/bluesky/thread
uriversion+5 optionalNeeds terms
1 credit
GET/v1/bluesky/typeahead-users
q+1 optionalNeeds terms
1 credit
GET/v1/bluesky/user-posts
actor+4 optionalNeeds terms
1 credit

Overview

About the Bluesky API

What you can get

The Bluesky API returns search posts, search users, followers and following as clean JSON. Each successful call costs one credit, and calls that fail are free.

Social mediaJSONRESTMCPSome endpoints need terms

More social media APIs

Use cases

Monitor mentions of your brand

Use the Bluesky API to monitor mentions of your brand

Find and vet creators

Use the Bluesky API to find and vet creators

Track trends and engagement over time

Use the Bluesky API to track trends and engagement over time

FAQ

Questions

How much does the Bluesky API cost?

Each successful call costs one credit. New accounts get free credits every month, and credit packs bring the price down as you scale.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Do I need a separate key for Bluesky?

No. One key works for every API in the catalogue.

Try the Bluesky API with 1,000 free credits

No credit card. Failed calls are never billed.