Česká Televize

Entertainment API · Works in Czech Republic · TV schedules · No API key

TL;DR

The Česká Televize (Czech Television) API provides program schedules and content metadata for all ČT channels: ČT1, ČT2, ČT24 (news), ČT sport, ČT :D (children), and ČT art. Query daily or weekly schedules, get program details including title, description, start time, duration and episode information. Supports date-based queries for past, present, and future programming. JSON format, no API key. Essential for Czech TV guide apps and media monitoring tools.

Quick start: https://api.ceskatelevize.cz/v1/epg/programme/?channel=ct1&date=2023-12-24

No API key needed — just make a request!

How to Use This API

1. Get Schedule for a Channel

https://api.ceskatelevize.cz/v1/epg/programme/?channel=ct1&date=2023-12-24

2. JavaScript — Today's TV Guide

const today = new Date().toISOString().split('T')[0];

fetch(`https://api.ceskatelevize.cz/v1/epg/programme/?channel=ct24&date=${today}`)
  .then(r => r.json())
  .then(data => {
    console.log(`ČT24 Schedule for ${today}:`);
    data.programme.forEach(p => {
      const start = p.startTime.slice(11, 16);
      console.log(`  ${start} — ${p.title}`);
      if (p.description) {
        console.log(`    ${p.description.slice(0, 60)}...`);
      }
    });
  });

3. Python — Find Programs by Keyword

import requests

keyword = 'dokument'
channels = ['ct1', 'ct2', 'ctart']
today = '2023-12-24'

found = []
for ch in channels:
    data = requests.get(
        'https://api.ceskatelevize.cz/v1/epg/programme/',
        params={'channel': ch, 'date': today}
    ).json()
    for p in data.get('programme', []):
        if keyword.lower() in p.get('title', '').lower():
            found.append((ch, p['title'], p['startTime']))

print(f"Dokumenty na ČT ({today}):")
for ch, title, time in found:
    print(f"  [{ch.upper()}] {time[:16]} — {title}")
ČT1 schedule: https://api.ceskatelevize.cz/v1/epg/programme/?channel=ct1&date=2023-12-24

Frequently Asked Questions

What channels are available?
ČT1 (main channel), ČT2 (culture/documentaries), ČT24 (24-hour news), ČT sport, ČT :D (children's), and ČT art (arts and culture). Channel IDs: ct1, ct2, ct24, ctsport, ctd, ctart.
What program data is returned?
Title, description, start time (ISO 8601), end time, duration (minutes), episode title/number, genre, rating, and original/modified flags.
Can I search by date range?
The API supports single-date queries. For longer ranges, make multiple requests. Schedule data is typically available 7-14 days in advance.
Does the API include live/current program?
Yes, querying today's date returns the current live schedule. The response includes all programs airing throughout the day.
Can I get program descriptions in other languages?
Program data is primarily in Czech. Some content may include English titles for international programming.
Is registration required?
The EPG (Electronic Program Guide) endpoint is publicly accessible without registration. Some ČT API endpoints may require authentication for user-specific features.

API Details

API URL
https://api.ceskatelevize.cz/v1/epg
Documentation
api.ceskatelevize.cz
Category
Entertainment
Authentication
Not Required (public EPG)
Geographic Coverage
Czech Republic (CZ)

What You Can Build