docs / bluesky

Bluesky

Profiles, posts, followers and the social graph.

base /bluesky/v113 endpoints

post/bluesky/v1/profile1 credit

actor profile: did/handle/displayName/desc/followers/follows/posts counts/avatar/banner/labels (+ batch via 'actors' <=25). Requires actor OR actors (engine-enforced; required_params=() so the actors-only batch isn't rejected by the gateway literal-key validator).

Parameter	Required
actor	optional
actors	optional

Try in playground →

post/bluesky/v1/author_feed1 credit

an actor's posts (full record+embed+counts), cursor-paginated; filter=posts_no_replies|posts_with_replies|posts_with_media|posts_and_author_threads

Parameter	Required
actor	required
limit	optional
filter	optional
cursor	optional

Try in playground →

post/bluesky/v1/search_actors1 credit

search users by name/handle/bio (cursor); typeahead=true for fast suggest

Parameter	Required
q	required
limit	optional
cursor	optional
typeahead	optional

Try in playground →

post/bluesky/v1/thread1 credit

a post + its reply tree (recursive) + parent

Parameter	Required
uri	required
depth	optional
parent_height	optional

Try in playground →

post/bluesky/v1/post_detail1 credit

hydrate one or more posts by at:// URI (<=25): record/embed/like+repost+reply+quote counts

Parameter	Required
uris	required

Try in playground →

post/bluesky/v1/likes1 credit

actors who liked a post (cursor); cid auto-used if given

Parameter	Required
uri	required
cid	optional
limit	optional
cursor	optional

Try in playground →

post/bluesky/v1/reposts1 credit

actors who reposted a post (cursor)

Parameter	Required
uri	required
cid	optional
limit	optional
cursor	optional

Try in playground →

post/bluesky/v1/followers1 credit

actors following the subject (cursor)

Parameter	Required
actor	required
limit	optional
cursor	optional

Try in playground →

post/bluesky/v1/follows1 credit

actors the subject follows (cursor)

Parameter	Required
actor	required
limit	optional
cursor	optional

Try in playground →

post/bluesky/v1/search_posts1 credit

keyword/hashtag post search (authed): q + sort=top|latest + since/until/author/lang/domain/tag, cursor. Without an app-password configured -> honest TARGET_BLOCKED.

Parameter	Required
q	required
sort	optional
limit	optional
cursor	optional
since	optional
until	optional
author	optional
mentions	optional
lang	optional
domain	optional
url	optional
tag	optional

Try in playground →

post/bluesky/v1/get_actor_likes1 credit

posts an actor liked (authed; the AppView serves the authenticated account's own likes). Defaults to the logged-in handle.

Parameter	Required
actor	optional
limit	optional
cursor	optional

Try in playground →

post/bluesky/v1/timeline1 credit

the authenticated account's home timeline (authed)

Parameter	Required
limit	optional
cursor	optional
algorithm	optional

Try in playground →

post/bluesky/v1/get_feed1 credit

posts from a custom feed generator by at:// URI (authed)

Parameter	Required
feed	required
limit	optional
cursor	optional

Try in playground →

Example request · profile

curl -X POST https://api.reefapi.com/bluesky/v1/profile \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"actor":"bsky.app"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}