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}")
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
- Czech TV guide app with channel-by-channel schedule browsing
- Program reminder system that notifies before favorite shows air
- Media monitoring tool tracking specific keywords across ČT programming
- Smart TV integration showing customized ČT program recommendations
- News archive indexer linking ČT24 broadcasts to related articles