# TV Guide API

> TV guide data for every channel worldwide: listings, now and next, shows and episodes, and the sport on air with live told apart from repeats, under one key. 52 REST endpoints covering 148 countries: TV listings, now and next, channels, shows, episodes, sports events and where to watch them. Factual data only: no predictions, ratings or tips.

## Complete reference

- [Full manual, one file](https://tvguideapi.com/documentation/manual.md): every endpoint, parameter, sample response and guide in a single markdown document.
- [OpenAPI](https://tvguideapi.com/openapi.json): machine-readable API description.
- [MCP server](https://api.tvguideapi.com/mcp): Model Context Protocol endpoint.

## Agent skill

- [TV Guide API agent skill](https://tvguideapi.com/.well-known/agent-skills/tvguideapi/SKILL.md): how agents use TV Guide API. Index: https://tvguideapi.com/.well-known/agent-skills/index.json

## Guides

- [Quick start](https://tvguideapi.com/documentation/quick-start): A key and your first call in a minute
- [Authentication](https://tvguideapi.com/documentation/authentication): Keys, bearer tokens and keeping them safe
- [Free key](https://tvguideapi.com/documentation/free-key): What the free key reads, and its daily limit
- [Times and days](https://tvguideapi.com/documentation/times-and-days): UTC everywhere, and how a local day is cut
- [Channel and show ids](https://tvguideapi.com/documentation/ids): One id per channel and show across every source
- [Paging and fields](https://tvguideapi.com/documentation/paging): Cursors, limits and asking for fewer fields
- [Use with Claude and agents](https://tvguideapi.com/documentation/claude-and-agents): Connect the MCP server, the agent skill and the manual
- [MCP server](https://tvguideapi.com/documentation/mcp): The Model Context Protocol endpoint and how to connect
- [MCP tools](https://tvguideapi.com/documentation/mcp-tools): Every tool the MCP server offers, with its inputs
- [Errors](https://tvguideapi.com/documentation/errors): Every error code, what it means and the fix
- [Limits and headers](https://tvguideapi.com/documentation/rate-limits): Daily calls, the headers that count them, and caching
- [Sources and licences](https://tvguideapi.com/documentation/data-sources): Where the data comes from and the credit it asks for
- [Changelog](https://tvguideapi.com/documentation/changelog): What changed, newest first

## Endpoints

- [GET /v1/channels](https://tvguideapi.com/documentation/channels): List channels
- [GET /v1/channels/search](https://tvguideapi.com/documentation/channels-search): Find a channel
- [GET /v1/channels/{id}](https://tvguideapi.com/documentation/channels-id): Get a channel
- [GET /v1/channels/{id}/schedule](https://tvguideapi.com/documentation/channels-id-schedule): A channel's schedule
- [GET /v1/channels/{id}/now](https://tvguideapi.com/documentation/channels-id-now): On a channel now
- [GET /v1/channels/{id}/next](https://tvguideapi.com/documentation/channels-id-next): Next on a channel
- [GET /v1/channels/{id}/free-view](https://tvguideapi.com/documentation/channels-id-free-view): Watch a channel free
- [GET /v1/channels/{id}/history](https://tvguideapi.com/documentation/channels-id-history): A channel's past schedules
- [GET /v1/countries](https://tvguideapi.com/documentation/countries): List countries
- [GET /v1/countries/{cc}](https://tvguideapi.com/documentation/countries-country): Get a country
- [GET /v1/countries/{cc}/channels](https://tvguideapi.com/documentation/countries-country-channels): A country's channels
- [GET /v1/countries/{cc}/now](https://tvguideapi.com/documentation/countries-country-now): Now in a country
- [GET /v1/countries/{cc}/tonight](https://tvguideapi.com/documentation/countries-country-tonight): Tonight in a country
- [GET /v1/countries/{cc}/coverage](https://tvguideapi.com/documentation/countries-country-coverage): Country coverage
- [GET /v1/guide](https://tvguideapi.com/documentation/guide): TV guide grid
- [GET /v1/now](https://tvguideapi.com/documentation/now): Now on
- [GET /v1/next](https://tvguideapi.com/documentation/next): Next on
- [GET /v1/listings/{id}](https://tvguideapi.com/documentation/listings-id): Get a listing
- [GET /v1/listings/search](https://tvguideapi.com/documentation/listings-search): Search listings
- [GET /v1/premieres](https://tvguideapi.com/documentation/premieres): Premieres
- [GET /v1/live](https://tvguideapi.com/documentation/live): Live slots
- [GET /v1/xmltv](https://tvguideapi.com/documentation/xmltv): XMLTV export
- [GET /v1/shows/search](https://tvguideapi.com/documentation/shows-search): Find a show
- [GET /v1/shows/{id}](https://tvguideapi.com/documentation/shows-id): Get a show
- [GET /v1/shows/{id}/episodes](https://tvguideapi.com/documentation/shows-id-episodes): A show's episodes
- [GET /v1/shows/{id}/cast](https://tvguideapi.com/documentation/shows-id-cast): A show's cast
- [GET /v1/shows/{id}/airings](https://tvguideapi.com/documentation/shows-id-airings): Where a show airs
- [GET /v1/shows/{id}/history](https://tvguideapi.com/documentation/shows-id-history): A show's past airings
- [GET /v1/episodes/{id}](https://tvguideapi.com/documentation/episodes-id): Get an episode
- [GET /v1/episodes/{id}/airings](https://tvguideapi.com/documentation/episodes-id-airings): Where an episode aired
- [GET /v1/networks](https://tvguideapi.com/documentation/networks): List networks
- [GET /v1/networks/{id}/shows](https://tvguideapi.com/documentation/networks-id-shows): A network's shows
- [GET /v1/sports](https://tvguideapi.com/documentation/sports): List sports
- [GET /v1/leagues](https://tvguideapi.com/documentation/leagues): List leagues
- [GET /v1/leagues/{id}/events](https://tvguideapi.com/documentation/leagues-id-events): A league's events
- [GET /v1/events](https://tvguideapi.com/documentation/events): Events
- [GET /v1/events/{id}](https://tvguideapi.com/documentation/events-id): Get an event
- [GET /v1/events/{id}/broadcasts](https://tvguideapi.com/documentation/events-id-broadcasts): Where to watch an event
- [GET /v1/events/live](https://tvguideapi.com/documentation/events-live): Live events now
- [GET /v1/events/upcoming](https://tvguideapi.com/documentation/events-upcoming): Upcoming events
- [GET /v1/events/{id}/replays](https://tvguideapi.com/documentation/events-id-replays): An event's replays
- [GET /v1/teams/{id}/events](https://tvguideapi.com/documentation/teams-id-events): Where a team is on
- [GET /v1/rights](https://tvguideapi.com/documentation/rights): Broadcast rights history
- [GET /v1/venue/tonight](https://tvguideapi.com/documentation/venue-tonight): Tonight's screens
- [GET /v1/venue/week](https://tvguideapi.com/documentation/venue-week): The week ahead
- [GET /v1/me](https://tvguideapi.com/documentation/me): Your account
- [GET /v1/usage](https://tvguideapi.com/documentation/usage): Your usage
- [GET /v1/status](https://tvguideapi.com/documentation/status): Status
- [GET /v1/fields](https://tvguideapi.com/documentation/fields): Field fill
- [GET /v1/sources](https://tvguideapi.com/documentation/sources): Sources and licences
- [POST /mcp](https://tvguideapi.com/documentation/mcp-endpoint): MCP endpoint
- [GET /.well-known/agent-skills/index.json](https://tvguideapi.com/documentation/agent-skills-index): Agent skill index