API Reference
Use Crawlora's Bluesky API endpoints to extract supported public Bluesky data as structured JSON. This documentation covers 7 active endpoints including A Bluesky account's posts, A Bluesky account's followers, Accounts a Bluesky account follows, A Bluesky post and its reply tree, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as actor, uri, q, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/bluesky/search-actors?q=coffee&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/bluesky/author-feedapiKey2 credits/requestReturns a page of a Bluesky account's posts, newest first, including text, engagement counts, and any attached images/link card/quoted post. Public data, sourced from the AT Protocol's public, credential-free AppView API.
Required params: actor:query
/bluesky/followersapiKey1 credit/requestReturns a page of a Bluesky account's followers. Public data, sourced from the AT Protocol's public, credential-free AppView API.
Required params: actor:query
/bluesky/followsapiKey1 credit/requestReturns a page of the accounts a Bluesky account follows. Public data, sourced from the AT Protocol's public, credential-free AppView API.
Required params: actor:query
/bluesky/post-threadapiKey1 credit/requestReturns a Bluesky post along with its nested replies (and, when the post is itself a reply, its parent chain), up to `depth` levels deep. Public data, sourced from the AT Protocol's public, credential-free AppView API.
Required params: uri:query
/bluesky/profileapiKey1 credit/requestReturns a Bluesky account's public profile: display name, description, avatar/banner images, and follower/follows/posts counts. Public data, sourced from the AT Protocol's public, credential-free AppView API.
Required params: actor:query
/bluesky/search-actorsapiKey2 credits/requestReturns Bluesky accounts matching a query against display name, handle, and profile description. Public data, sourced from the AT Protocol's public, credential-free AppView API.
Required params: q:query
/bluesky/trending-topicsapiKey1 credit/requestReturns Bluesky's current trending topics and suggested feeds, each with a link to its feed. Public data, sourced from the AT Protocol's public, credential-free AppView API. This surface is less stable than the rest of this family -- Bluesky may change its shape without notice.
Required params: None
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| A Bluesky account's posts | /bluesky/author-feed | GET | 2 credits/request | actor:query | View docs | Try endpoint |
| A Bluesky account's followers | /bluesky/followers | GET | 1 credit/request | actor:query | View docs | Try endpoint |
| Accounts a Bluesky account follows | /bluesky/follows | GET | 1 credit/request | actor:query | View docs | Try endpoint |
| A Bluesky post and its reply tree | /bluesky/post-thread | GET | 1 credit/request | uri:query | View docs | Try endpoint |
| A Bluesky account's full public profile | /bluesky/profile | GET | 1 credit/request | actor:query | View docs | Try endpoint |
| Search Bluesky accounts | /bluesky/search-actors | GET | 2 credits/request | q:query | View docs | Try endpoint |
| Bluesky's current trending topics | /bluesky/trending-topics | GET | 1 credit/request | None | View docs | Try endpoint |