All endpoints
Bluesky User Followers

Bluesky User Followers API

Get the followers of a Bluesky user, newest first. Returns handle, display name, DID, bio, verification status, profile picture, and join date for each follower.

Price: $0.003 per page
Free tier: 50 requests/month
Get API Key Documentation
Endpoint
GET /v1/bluesky/user/followers

Parameters

username
Bluesky handle, e.g. bsky.app, with or without leading @, or the account's DID (max 100 characters). Provide either username or url.
url
Bluesky profile URL, e.g. https://bsky.app/profile/bsky.app (max 500 characters). Provide either username or url.
pages
Number of pages to fetch, 1-20 (default: 1). Each page returns up to 50 accounts; you are billed per page returned.

Response fields

followers
Array of follower profiles, newest first
username
Bluesky handle
full_name
Display name
user_id
DID (permanent account ID)
biography
Profile description
is_verified
Whether the account is verified
profile_pic_url
URL to profile picture
date_joined
Account creation date and time
url
Link to the profile
username
The requested handle or DID
pages
Number of pages returned
count
Number of results returned

Example Request

curl "https://apidirect.io/v1/bluesky/user/followers?username=bsky.app&pages=1"   -H "X-API-Key: YOUR_API_KEY"

Example Response

{
  "followers": [
    {
      "username": "useforgekit.bsky.social",
      "full_name": "ForgeKit",
      "user_id": "did:plc:fmtj42jmivqv5ffhhniuflov",
      "biography": "Screenshot & PDF API without Puppeteer. One credit pool for screenshots, PDFs, OG images, QR, link previews. Agent-ready (MCP). https://useforgekit.de…",
      "is_verified": false,
      "profile_pic_url": "https://cdn.bsky.app/img/avatar/plain/did:plc:fmtj42jmivqv5ffhhniuflov/bafkreiflnuwjcrdi36s3h63xqgrn6gumysxuhl7g4fyg5poc7mqegqhp2u",
      "date_joined": "2026-09-03 00:11:18",
      "url": "https://bsky.app/profile/useforgekit.bsky.social"
    }
  ],
  "username": "bsky.app",
  "pages": 1,
  "count": 50
}

Frequently asked questions

In what order are followers returned?

Most recent followers first.

How many followers can I fetch in one call?

Up to 20 pages of 50 accounts (1,000 followers). You are billed only for the pages that come back, so a small account never costs more than its follower list.

How does pricing work?

You only pay for successful requests. The Bluesky User Followers API costs $0.003 per page. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 10 simultaneous requests per endpoint per user. If you need more, just get in touch.

Start using the Bluesky User Followers API

Get your API key and start making requests in minutes. 50 requests/month free every month.

Get API Key