API Docs / Listings
Listings guide
A channel's day, a country's day and XMLTV, with time zones.
A channel's day slot by slot, a whole country's day, and XMLTV for players and EPG software. The free key reads yesterday; Live and Complete read 7 days back to 7 ahead.
A channel's scheduleGET /v1/channels/{id}/schedule/{date}A channel's day, slot by slot, times in UTC. The date is YYYY-MM-DD, yesterday, today or tomorrow. A country's scheduleGET /v1/countries/{cc}/schedule/{date}Every channel in a country for a day, 50 channels a page. XMLTV for a channelGET /v1/xmltv/channels/{id}A channel as an XMLTV file, today and the days ahead in your window.
Days and time zones
The date is YYYY-MM-DD, or yesterday, today or tomorrow. Every time in the answer is UTC. Add tz to choose which local day is cut, so a UK evening is not split across two dates:
curl
curl "https://api.tvschedule.org/v1/channels/ch_jw83a3xg/schedule/today?tz=Europe/London" -H "X-API-Key: $TVS_KEY"
Repeats and episodes
Each slot carries flags (new, live, repeat) and, where the programme is matched to a show, episode with the show id, which leads to the shows endpoints.
XMLTV
/v1/xmltv/channels/{id} gives a channel as an XMLTV file covering today and the days ahead in your plan, for Kodi, Plex, Jellyfin and any EPG reader.