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 playgroundTV 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)
| Endpoint | What it returns |
|---|---|
GET/search | Search shows Search TV shows by name (fuzzy). Returns up to 10 matches with relevance score. |
GET/show | Show 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/cast | Cast & crew Cast with character names and photos, plus crew members and their roles. |
GET/updates | Recently updated shows Shows whose data changed in the last day, week or month, most recent first. |
GET/episodes | Episode list All episodes of a show, or of one season, with air dates, runtime, rating and summary. |
GET/episode | Single episode One episode by season and episode number. |
GET/schedule | TV / 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/search | Search people Search actors and crew by name. |
GET/person | Person & 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'import requests
url = "https://tv-shows-schedule-api1.p.rapidapi.com/search?query=breaking+bad&limit=2"
headers = {
"x-rapidapi-host": "tv-shows-schedule-api1.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY",
}
resp = requests.get(url, headers=headers)
print(resp.json())const res = await fetch("https://tv-shows-schedule-api1.p.rapidapi.com/search?query=breaking+bad&limit=2", {
method: "GET",
headers: {
"x-rapidapi-host": "tv-shows-schedule-api1.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
});
console.log(await res.json());
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 RapidAPIRelated APIs
Twitch Data
Twitch channel profiles & live status, top live streams by game, top categories, clips, VODs and channel search. No OAuth token, no setup.
EntertainmentJokes 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.