# Bluesky User Search

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

Search for Bluesky users by keyword, returning paginated results of matching profiles.

## Facts

- Endpoint: GET https://x402.apidirect.io/v1/bluesky/users?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-search-07f7a930
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_exgiEmX3p0FH7fk5EUtFv

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-search-07f7a930
```

Example prompt: Search Bluesky for users related to 'machine learning' and bring back 2 pages of results so I can see who's active in that space.

## When to prefer this

Use this endpoint when you need to discover or enumerate Bluesky user accounts matching a specific keyword, name, or topic. It is ideal for building follower lists, performing influencer research, or auditing who is active on Bluesky around a subject. Prefer this over general web search when you specifically need structured Bluesky profile data rather than posts or content.

## Known failure modes

- Empty results if no Bluesky users match the keyword
- Rate limiting or payment failure if USDC balance is insufficient
- Query too long if keyword exceeds 500 characters
- Invalid pages parameter if outside the 1-20 range
- Network timeout if Bluesky's API is slow or unavailable

## How this service works

Search Bluesky users by keyword.

## Output

Returns a merged list of up to 50 Bluesky user profiles per page (up to 20 pages), including usernames and account details matching the search keyword. Fetching stops early if no more results are available.

## 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": [
      "query"
     ],
     "properties": {
      "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."
      },
      "query": {
       "type": "string",
       "maxLength": 500,
       "description": "Search keyword (max 500 characters)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bluesky-user-search-07f7a930/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)