# Swarmio Video Search

> Swarmio Video Search is a paid API for AI agents from ioswarm.io, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-14).

Searches YouTube for videos by keyword with optional recency, duration, and sort filters, returning ranked results with metadata.

## Facts

- Endpoint: POST https://ioswarm.io/api/v1/video/search?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/swarmio-video-search-6160249f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fqkCLdayFHoigZiux3jZ5

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 swarmio-video-search-6160249f -d '<json body>'
```

Example prompt: Search for the top 5 YouTube videos about 'rust async runtime' from the past week, sorted by rating, and show me the titles, channels, and view counts.

## When to prefer this

Use this endpoint when you need structured, filterable YouTube video search results with metadata like view counts and duration — especially when recency is important (the `within` parameter is the only way to guarantee genuinely fresh results). Prefer this over general web search when you specifically need video content with channel attribution and engagement metrics. It is well-suited for agents that need to surface trending video content, conduct research on multimedia coverage of a topic, or build video recommendation workflows.

## Known failure modes

- Invalid sort enum value returns a validation error
- Invalid within enum value returns a validation error
- Invalid duration enum value returns a validation error
- limit out of range (< 1 or > 50) returns a validation error
- Empty or missing query returns an error
- Payment failure (insufficient USDC) blocks the request
- Daily free quota exhausted may require payment
- YouTube backend unavailability returns a service error

## How this service works

Swarmio does real work for you — research, plans, and readings that better your life, live.

## Output

Returns a JSON object with the total count of results, the search query echoed back, quota usage (free calls remaining today), payment confirmation, and an array of up to 50 video objects each containing: video ID, full YouTube URL, title, channel name, view count, live status, and duration in seconds.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "enum": [
    "relevance",
    "rating",
    "date",
    "views"
   ],
   "type": "string"
  },
  "limit": {
   "type": "integer",
   "description": "results, 1-50 (default 10)"
  },
  "query": {
   "type": "string",
   "description": "what to search for"
  },
  "within": {
   "enum": [
    "hour",
    "today",
    "week",
    "month",
    "year"
   ],
   "type": "string",
   "description": "recency filter (server-side; the only way to get genuinely recent results)"
  },
  "duration": {
   "enum": [
    "short",
    "medium",
    "long"
   ],
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "paid": {
   "usd": 0.02,
   "transaction": "0x…"
  },
  "count": 10,
  "known": true,
  "query": "rust async runtime",
  "quota": {
   "free_per_day": 25,
   "free_remaining_today": 22
  },
  "results": [
   {
    "id": "…",
    "url": "https://www.youtube.com/watch?v=…",
    "title": "…",
    "channel": "…",
    "view_count": 120000,
    "live_status": null,
    "duration_sec": 1834
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/swarmio-video-search-6160249f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ioswarm.io](https://www.zero.xyz/host/ioswarm.io/llms.txt)