All endpoints
Bluesky User Following

Bluesky User Following API

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

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

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

following
Array of followed 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/following?username=pfrazee.com&pages=1"   -H "X-API-Key: YOUR_API_KEY"

Example Response

{
  "following": [
    {
      "username": "wired.sister.haus",
      "full_name": "evil_sister.rb",
      "user_id": "did:plc:m6stoaqv4ocgbn4icbwj7chp",
      "biography": "dream sender",
      "is_verified": false,
      "profile_pic_url": "https://cdn.bsky.app/img/avatar/plain/did:plc:m6stoaqv4ocgbn4icbwj7chp/bafkreifzlrytu464rba7tkbted4qzw5ovz6z5bxk2r26uctjespgz5dul4",
      "date_joined": "2026-04-14 23:30:04",
      "url": "https://bsky.app/profile/wired.sister.haus"
    }
  ],
  "username": "pfrazee.com",
  "pages": 1,
  "count": 50
}

Frequently asked questions

In what order are accounts returned?

Most recently followed first.

How many accounts can I fetch in one call?

Up to 20 pages of 50 accounts (1,000). You are billed only for the pages that come back.

How does pricing work?

You only pay for successful requests. The Bluesky User Following 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 Following API

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

Get API Key