# TVMaze Show Search via x402

> TVMaze Show Search via x402 is a paid API for AI agents from x402-v2-mint-tvmaze-search.vercel.app, paid per call via x402, $0.002/call, status unknown (last checked 2026-11-01).

Searches the TVMaze database for TV shows by query term, returning trimmed show metadata including name, type, language, genres, status, rating, URL, and image.

## Facts

- Endpoint: POST https://x402-v2-mint-tvmaze-search.vercel.app/v1/tvmaze-search?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tvmaze-show-search-via-x402-07ebd9d5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QzNVrQqS_oU96_AGwpWKC

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 tvmaze-show-search-via-x402-07ebd9d5 -d '<json body>'
```

Example prompt: Can you search for TV shows matching 'Breaking Bad' and tell me the genre, current status, rating, and a link to its page?

## When to prefer this

Choose this endpoint when you need quick, keyless access to TV show metadata from TVMaze without managing your own API keys. It's ideal for agents that need to look up show details on demand and can pay per-call via the x402 micropayment protocol. Prefer it over direct TVMaze API calls when you want a managed, pre-trimmed response without setting up authentication.

## Known failure modes

- Empty or missing query returns no results or an error
- Very obscure show titles may return zero matches
- Network timeout or Vercel cold start may cause slow or failed responses
- Malformed request body may result in a 400-level error
- Payment failure (x402 protocol) may block access before the search executes

## How this service works

TVMaze show search (keyless). q → trimmed shows (name/type/language/genres/status/rating/url/image).

## Output

Returns a JSON object with ok status, the skill name ('tvmaze-search'), a charged flag, and a summary field. The core payload includes trimmed show records with fields: name, type, language, genres (array), status (e.g. Running/Ended), rating score, official URL, and image URLs (medium/original).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "maxLength": 200,
   "description": "Show search query"
  },
  "term": {
   "type": "string",
   "maxLength": 200
  },
  "query": {
   "type": "string",
   "maxLength": 200
  },
  "request_id": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "skill": "tvmaze-search",
  "charged": true,
  "summary": "ok"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tvmaze-show-search-via-x402-07ebd9d5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-v2-mint-tvmaze-search.vercel.app](https://www.zero.xyz/host/x402-v2-mint-tvmaze-search.vercel.app/llms.txt)
