# Bluesky User Following List

> Bluesky User Following List 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).

Returns the list of accounts a Bluesky user follows, paginated and sorted newest first.

## Facts

- Endpoint: GET https://x402.apidirect.io/v1/bluesky/user/following?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/bluesky-user-following-list-a82ef590
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eRjxG2oFMjJBkzzMM4pmy

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 bluesky-user-following-list-a82ef590
```

Example prompt: Can you fetch the full list of accounts that @jack.bsky.social follows on Bluesky, going through up to 3 pages so I get at least 150 results?

## When to prefer this

Use this endpoint when you need to programmatically retrieve the following list of a Bluesky user by handle, profile URL, or DID, especially when multi-page aggregation (up to 1000 accounts in one call) is needed. Prefer it over scraping bsky.app directly or using the raw AT Protocol API when you want a simple, paid REST interface with merged pagination.

## Known failure modes

- Unknown or misspelled Bluesky handle returns a not-found error
- Private or deactivated accounts may return empty or restricted results
- Exceeding the 20-page maximum causes a validation error
- Providing neither username nor url causes a missing-parameter error
- Rate limits or Bluesky API downtime may cause timeout or 5xx errors

## How this service works

Get the accounts a Bluesky user follows, newest first.

## Output

A merged, paginated list of Bluesky accounts that the specified user follows, sorted newest first. Each entry typically includes the account handle, DID, display name, and profile metadata. Up to 50 results per page, up to 20 pages can be fetched in a single call (billed per page returned).

## 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/bluesky-user-following-list-a82ef590/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)