# API Direct – Bluesky User Followers

> API Direct – Bluesky User Followers is a paid API for AI agents from x402.apidirect.io, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-30).

Retrieves the followers of a Bluesky user account, ordered from newest to oldest, with pagination support.

## Facts

- Endpoint: GET https://x402.apidirect.io/v1/bluesky/user/followers?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-direct-bluesky-user-followers-87db0885
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xFhbiz8Nl0aY35ojDJNdp

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability api-direct-bluesky-user-followers-87db0885
```

Example prompt: Can you get me the most recent followers of the Bluesky account @jack.bsky.social — fetch 2 pages so I get up to 100 results?

## When to prefer this

Use this endpoint when you need to retrieve the follower social graph of a specific Bluesky user, especially when you want results sorted newest-first or need multi-page batch retrieval in a single call. Prefer this over scraping or manual lookups when building follower analytics, audience research tools, or growth monitoring workflows on Bluesky.

## Known failure modes

- Unknown or invalid username/DID returns an error or empty result
- Profile URL in wrong format causes a parsing failure
- Requesting more than 20 pages exceeds the maximum and is rejected
- Account with zero followers returns an empty list
- Rate limiting or payment failure may result in a 402 or 429 error
- Private or deactivated accounts may return no follower data

## How this service works

Get the followers of a Bluesky user, newest first.

## Output

Returns a paginated list of follower profiles for the specified Bluesky user, ordered from newest follower to oldest. Each page contains up to 50 follower records. Multiple pages can be fetched and merged in a single call (up to 20 pages, billed per page returned). The response includes follower account details such as handles, DIDs, and display names.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "url": {
       "type": "string",
       "maxLength": 500,
       "description": "Bluesky profile URL, e.g. https://bsky.app/profile/bsky.app (max 500 characters). Provide either username or url."
      },
      "pages": {
       "type": "integer",
       "default": 1,
       "maximum": 20,
       "minimum": 1,
       "description": "Number of pages to fetch and merge into one response (1-20, billed per page returned). Each page returns up to 50 results. Fetching stops early when there are no more results."
      },
      "username": {
       "type": "string",
       "maxLength": 100,
       "description": "Bluesky handle, e.g. bsky.app, with or without leading @, or the account's DID (max 100 characters). Provide either username or url."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-direct-bluesky-user-followers-87db0885/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.apidirect.io](https://www.zero.xyz/host/x402.apidirect.io/llms.txt)