# Vextorium Bluesky Search

> Vextorium Bluesky Search is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-18).

Search public Bluesky posts by keyword, returning author, text, engagement metrics, and post links sorted by top or latest via the AT Protocol public API.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/bluesky-search?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-bluesky-search-4146c518
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jTUfSBSDThkFiXsWzbaZ8

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 vextorium-bluesky-search-4146c518 -d '<json body>'
```

Example prompt: Search Bluesky for the top 10 posts mentioning 'climate change' and show me which ones have the most likes and reposts.

## When to prefer this

Choose this endpoint when you need to search public Bluesky posts specifically — it provides real-time AT Protocol data with full engagement metrics (likes, reposts, replies, quotes) and author identity. Prefer this over Twitter/X search tools when your user explicitly wants Bluesky content, or when you need decentralized social media data. The top vs latest sort modes make it suitable for both trend discovery and real-time monitoring.

## Known failure modes

- Empty results if query matches no public Bluesky posts
- Rate limiting or quota exhaustion from the underlying AT Protocol API returning no data
- Invalid sort enum value causing a request error
- Limit parameter exceeding API maximum returning fewer results than requested
- Bluesky API downtime causing failed upstream fetch

## How this service works

558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.

## Output

Returns a JSON object with the search query, sort method, total hit count, total engagement, and an array of matching posts each containing: post URL, text, author handle, author display name, likes, reposts, quotes, replies, and creation timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "enum": [
    "top",
    "latest"
   ],
   "type": "string"
  },
  "limit": {
   "type": "integer"
  },
  "query": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "sort": "top",
  "count": 7,
  "posts": [
   {
    "url": "https://bsky.app/profile/kevinmkruse.bsky.social/post/3mx333hlmdc2o",
    "text": "My man looks like a beluga whale pitching Bitcoin",
    "likes": 7162,
    "author": "kevinmkruse.bsky.social",
    "quotes": 346,
    "replies": 666,
    "reposts": 755,
    "created_at": "2026-10-04T18:52:02.868Z",
    "author_name": "Kevin M. Kruse"
   },
   {
    "url": "https://bsky.app/profile/chadbourn.bsky.social/post/3lm6ecjsqjk2c",
    "text": "Bitcoin.",
    "likes": 921,
    "author": "chadbourn.bsky.social",
    "quotes": 219,
    "replies": 119,
    "reposts": 237,
    "created_at": "2025-04-06T21:11:42.987Z",
    "author_name": "Mark Chadbourn"
   }
  ],
  "query": "bitcoin",
  "source": "Bluesky public API (AT Protocol)",
  "total_hits": 10000,
  "total_engagement": 21641
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-bluesky-search-4146c518/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)