Lumeo APIs
Entertainment

TV Shows & Schedule API

TV series data: search, show details, seasons & episodes with air dates, cast & crew, TV and streaming schedules by country, people and credits.

Get a free API key on RapidAPI Try it in the playground

TV Shows & Schedule API

Everything about television in one API — from the classic network schedule to today's streaming premieres.

📺 Shows

Search by name, or look up by TVmaze id or IMDb id. Get genres, status, network / streaming service, rating, schedule, images, summary, all seasons, and the previous and next episode.

🎞️ Episodes

Full episode lists (optionally one season, with specials), or a single episode by season and number — with air date and time, runtime, rating, image and summary.

🗓️ Schedule

What's on TV today in any country, or what premieres on streaming services — filter by genre or primetime.

🎭 Cast & people

Cast with characters and photos, crew roles, people search, and each person's full list of TV credits.

🔄 Updates

Recently updated shows (day / week / month) to keep your catalog in sync.

Use cases: episode trackers & calendars · TV guides · streaming-app metadata · Discord / Telegram bots · recommendation engines · smart-TV widgets

Keywords: tv shows api, tv series api, episodes api, tv schedule api, tv guide, air dates, tvmaze, streaming premieres, cast and crew, imdb id lookup

Endpoints (9)

EndpointWhat it returns
GET/searchSearch shows
Search TV shows by name (fuzzy). Returns up to 10 matches with relevance score.
GET/showShow details
Full details of a show: genres, status, network or streaming service, rating, schedule, images, summary, all seasons, and the previous and next episode.
GET/castCast & crew
Cast with character names and photos, plus crew members and their roles.
GET/updatesRecently updated shows
Shows whose data changed in the last day, week or month, most recent first.
GET/episodesEpisode list
All episodes of a show, or of one season, with air dates, runtime, rating and summary.
GET/episodeSingle episode
One episode by season and episode number.
GET/scheduleTV / streaming schedule
Episodes airing on a date in a country — on broadcast TV (`source=tv`) or premiering on streaming services (`source=streaming`). Filter by genre or primetime (19:00-23:00).
GET/people/searchSearch people
Search actors and crew by name.
GET/personPerson & credits
A person's profile and all TV cast credits (show, character, year), newest first.

Quick start

Subscribe on RapidAPI (free plan available), copy your key, and call GET /search:

curl --request GET \
  --url 'https://tv-shows-schedule-api1.p.rapidapi.com/search?query=breaking+bad&limit=2' \
  --header 'x-rapidapi-host: tv-shows-schedule-api1.p.rapidapi.com' \
  --header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'

Example response

{
  "query": "breaking bad",
  "count": 2,
  "shows": [
    {
      "score": 1.183,
      "id": 169,
      "name": "Breaking Bad",
      "type": "Scripted",
      "language": "English",
      "genres": [
        "Drama",
        "Crime"
      ],
      "status": "Ended",
      "premiered": "2008-01-20",
      "ended": "2019-10-11",
      "runtime_minutes": 60,
      "rating": 9.2,
      "network": "AMC",
      "network_type": "tv",
      "country": "US",
      "schedule": {
        "days": [
          "Sunday"
        ],
        "time": "22:00"
      },
      "official_site": "http://www.amc.com/shows/breaking-bad",
      "imdb_id": "tt0903747",
      "tvdb_id": 81189,
      "image": {
        "medium": "https://static.tvmaze.com/uploads/images/medium_portrait/501/1253519.jpg",
        "original": "https://static.tvmaze.com/uploads/images/original_untouched/501/1253519.jpg"
      },
      "summary": "Breaking Bad follows protagonist Walter White, a chemistry teacher who lives in New Mexico with his wife and teenage son who has cerebral palsy. White is diagnosed with Stage III cancer and given a prognosis of two years…",
      "url": "https://www.tvmaze.com/shows/169/breaking-bad",
      "updated": "2026-10-23T22:36:49.000Z"
    },
    {
      "score": 0.885,
      "id": 27845,
      "name": "Breaking Bad: Original Minisodes",
      "type": "Scripted",
      "language": "English",
      "genres": [
        "Comedy",
        "Crime"
      ],
      "status": "Ended",
      "premiered": "2009-02-17",
      "ended": "2011-07-11",
      "runtime_minutes": 5,
      "rating": 7,
      "network": "AMC",
      "network_type": "tv",
      "country": "US",
      "schedule": null,
      "official_site": "https://www.amc.com/shows/breaking-bad/talk/2009/02/original-minisodes#:~:text=Now%20you%20can%20watch%20five,and%20Matt%20Jones%20(Badger).",
      "imdb_id": "tt2387761",
      "tvdb_id": 356427,
      "image": {
        "medium": "https://static.tvmaze.com/uploads/images/medium_portrait/216/540867.jpg",
        "original": "https://static.tvmaze.com/uploads/images/original_untouched/216/540867.jpg"
      },
      "summary": "Watch Hank and Marie as they celebrate Valentine's Day in the bedroom in \"Good Cop, Bad Cop\". View a flashback to Hank and Marie's wedding as the groom discusses with Walt his last wild night as a bachelor in \"Wedding Da…",
      "url": "https://www.tvmaze.com/shows/27845/breaking-bad-original-minisodes",
      "updated": "2020-06-27T15:23:35.

Start free. Every plan includes all endpoints; upgrade only when you need more requests. Runs on Cloudflare's global network for low latency worldwide.

Subscribe on RapidAPI

Related APIs

Entertainment

Twitch Data

Twitch channel profiles & live status, top live streams by game, top categories, clips, VODs and channel search. No OAuth token, no setup.

Entertainment

Jokes API - Dad Jokes, Puns, Programming & More

Thousands of jokes from 3 sources in one format: dad jokes, puns, programming, Chuck Norris; safe-mode filter, 6 languages, search & joke of the day.