# Bluesky Actor Search API (x402)

> Bluesky Actor Search API (x402) is a paid API for AI agents from api.naco.li, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Searches Bluesky social network actors (users/accounts) by query string, returning profile details including handle, follower counts, and bio.

## Facts

- Endpoint: POST https://api.naco.li/v1/searchActors
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bluesky-actor-search-api-x402-9b6e8210
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eyY1kGD_pKiztOaufVPru

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-actor-search-api-x402-9b6e8210 -d '<json body>'
```

Example prompt: Can you search Bluesky for accounts related to 'machine learning' and show me the top 10 results with their follower counts and bios?

## When to prefer this

Choose this endpoint when you need to search for Bluesky-specific users or actors by keyword, name, or topic — especially useful for agents operating in the AT Protocol/Bluesky ecosystem or needing decentralized social graph data. Prefer this over Twitter/X search APIs when the target platform is specifically Bluesky, or when you need micropayment-gated, agent-friendly access via the x402 protocol.

## Known failure modes

- Empty or null results array when no users match the query
- Missing optional fields (bio, displayName, avatarUrl) for some profiles that have incomplete data
- Rate limiting or payment failure if x402 micropayment is not properly handled
- Query too broad returning irrelevant results
- Network timeout for unusual or complex queries

## How this service works

Auto-generated REST API matching active Model Context Protocol (MCP) tools.

## Output

Returns an array of Bluesky user profile objects, each containing the platform name, handle, display name, bio, follower count, following count, post count, avatar URL, and profile URL. The results array may be null if no matches are found.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query"
 ],
 "properties": {
  "limit": {
   "type": "integer"
  },
  "query": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "results"
 ],
 "properties": {
  "results": {
   "type": [
    "null",
    "array"
   ],
   "items": {
    "type": [
     "null",
     "object"
    ],
    "required": [
     "platform",
     "handle",
     "followersCount",
     "followingCount",
     "postCount"
    ],
    "properties": {
     "bio": {
      "type": "string"
     },
     "url": {
      "type": "string"
     },
     "handle": {
      "type": "string"
     },
     "platform": {
      "type": "string"
     },
     "avatarUrl": {
      "type": "string"
     },
     "postCount": {
      "type": "integer"
     },
     "displayName": {
      "type": "string"
     },
     "followersCount": {
      "type": "integer"
     },
     "followingCount": {
      "type": "integer"
     }
    },
    "additionalProperties": false
   }
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bluesky-actor-search-api-x402-9b6e8210/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.naco.li](https://www.zero.xyz/host/api.naco.li/llms.txt)