TVMaze

How to Use This API

1. Search for a Show

https://api.tvmaze.com/search/shows?q=breaking%20bad

2. Get Show by TVmaze ID

https://api.tvmaze.com/shows/169

169 = Breaking Bad.

3. Episode List for a Show

https://api.tvmaze.com/shows/169/episodes

4. Today's TV Schedule

https://api.tvmaze.com/schedule?country=US&date=2026-06-16

5. JavaScript — Find Next Episode

async function nextEpisode(showName) {
  const search = await fetch(
    `https://api.tvmaze.com/search/shows?q=${showName}`
  );
  const results = await search.json();
  if (!results.length) { console.log('Show not found'); return; }
  
  const show = results[0].show;
  const episodes = await fetch(
    `https://api.tvmaze.com/shows/${show.id}/episodes`
  );
  const allEp = await episodes.json();
  
  const now = new Date();
  const upcoming = allEp.filter(ep => new Date(ep.airstamp) > now);
  
  if (upcoming.length) {
    const next = upcoming[0];
    console.log(`Next ${show.name}: S${next.season}E${next.number}`);
    console.log(`"${next.name}" — ${next.airdate}`);
  } else {
    console.log(`No upcoming ${show.name} episodes found`);
  }
}

nextEpisode('stranger things');

6. Python — Show Cast

import requests

def get_cast(show_name):
    search = requests.get(
        'https://api.tvmaze.com/search/shows',
        params={'q': show_name}
    ).json()
    if not search:
        print('Show not found')
        return
    
    show_id = search[0]['show']['id']
    cast = requests.get(
        f'https://api.tvmaze.com/shows/{show_id}/cast'
    ).json()
    
    print(f"Cast of {search[0]['show']['name']}:")
    for person in cast[:10]:
        char = person['character']['name']
        actor = person['person']['name']
        print(f"  {char} — played by {actor}")

get_cast('the office')