TV Guide API Documentation
52 endpoints. One key. Every channel in 148 countries.Listings, now and next, shows and episodes, and the sport on air with live told apart from repeats. One shape, one set of ids, every time in UTC.
Before anything else
This is factual schedule data: what is on, where and when, as the channels publish it, corrected where a feed runs on the wrong clock. There are no video streams, no audience figures and no provider channel numbers. Fields we join in, such as episodes and events, sit in their own objects and say how they were matched.
Endpoints by group
The channel registry: one id per channel across every source, with names, owners, logos, launch years and each channel's schedule.
8 endpoints CountriesEverything at once for one country: its channels, what is on now, prime time tonight and how full its data is.
6 endpoints GuideSlots across many channels: grids, now and next, search, premieres, live slots and XMLTV files.
8 endpoints Shows and episodesSeries and episodes with their ids, and every place and time they air, first run and repeats.
10 endpoints Sport and eventsSports events found in the listings of every country, joined to fixtures, with each channel showing them and whether it is live or a repeat.
11 endpoints Venue plansFor bars and venues: what to put on the screens tonight and in the week ahead, live first.
2 endpoints Account and metaYour plan, keys and usage, the freshness of every source, field fill by country, and the sources with their licences.
5 endpoints AgentsThe MCP server and the agent skill index.
2 endpointsUse with Claude and agents
The MCP server, the agent skill and the whole manual as one file: connect in a minute.