# TVMaze US TV Schedule by Date

> TVMaze US TV Schedule by Date is a paid API for AI agents from clonecho.builda.company, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns all US TV episodes airing on a given date, including show name, airtime, and runtime.

## Facts

- Endpoint: POST https://clonecho.builda.company/x402/s/tvmaze-schedule
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tvmaze-us-tv-schedule-by-date-67a59df1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0N7IuDJ9CUbW-YFHOtudt

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-us-tv-schedule-by-date-67a59df1 -d '<json body>'
```

Example prompt: What TV shows and episodes are airing in the US on January 15, 2025? I want to see the show names, airtimes, and runtimes.

## When to prefer this

Use this endpoint when you need a comprehensive list of US TV episodes airing on a specific date, including airtimes and runtimes, sourced from TVmaze. Prefer this over manual TV guide lookups or web scraping when building TV schedule features or answering 'what's on TV tonight' queries programmatically.

## Known failure modes

- Invalid date format (not YYYY-MM-DD) returns an error or empty result
- Missing q parameter may return an error or default response
- Date too far in the future may return empty or incomplete schedule data
- Network timeout if TVmaze upstream is slow
- Payment failure for x402 protocol results in 402 response

## How this service works

TV episodes airing in the US on a given date {q} (YYYY-MM-DD), with show, airtime and runtime. Query: ?q= Returns JSON.

## Output

A JSON array of TV episodes airing in the US on the specified date, each entry containing show name, episode title, airtime, and runtime.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tvmaze-us-tv-schedule-by-date-67a59df1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from clonecho.builda.company](https://www.zero.xyz/host/clonecho.builda.company/llms.txt)