Media, Film & Knowledge

Movies & TV API

The Movies & TV API returns film and television metadata as clean JSON.

23 actionsLive JSON1,000 free creditsMCP-ready
Get a free keyOpen in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

The primary search endpoint returns title rows with cross-IDs (IMDb, TMDb, TVmaze), year and overview, and you can pull a detail, episodes, cast, crew, alternate titles and a schedule. It is built for entertainment apps, recommendation engines and media research that need unified movie and TV data without a scraper. One ReefAPI key, one shared credit pool, the standard { ok, data, meta, error } envelope.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/movies-tv/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "breaking bad",
    "type": "tv"
  }
}
Captured response
{
  "ok": true,
  "meta": {
    "api": "movies-tv",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 218.4,
    "record_count": 8,
    "bytes": 12220,
    "cache_hit": false,
    "completeness_pct": 100,
    "requests": 1,
    "license": "CC-BY-SA 4.0 (TVmaze)",
    "attribution": "TV data by TVmaze.com (CC BY-SA); This product uses the TMDB API but is not endorsed or certified by TMDB.; streaming via JustWatch"
  },
  "data": {
    "query": "breaking bad",
    "type": "tv",
    "results": [
      {
        "ids": {
          "tvmaze": 169,
          "imdb": "tt0903747",
          "thetvdb": 81189,
          "tvrage": 18164
        },
        "type": "tv",
        "title": "Breaking Bad",
        "year": 2008,
        "premiered": "[redacted-phone]",
        "ended": "[redacted-phone]",
        "genres": [
          "Drama",
          "Crime",
          "Thriller"
        ],
        "runtime": 60,
        "status": "Ended",
        "language": "English",
        "show_type": "Scripted",
        "overview": "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 left to live. With a new sense of fearlessness based on his medical prognosis, and a desire to secure his family's financial security, White chooses to enter a dangerous world of drugs and crime and ascends to power in this world. The series explores how a fatal diagnosis such as White's releases a typical man from the daily concerns and constraints of normal society and follo",
        "rating": {
          "tvmaze": 9.2
        },
        "network": "AMC",
        "country": "United States",
        "schedule": {
          "time": "22:00",
          "days": [
            "[trimmed-depth]"
          ]
        },
        "poster": "https://static.tvmaze.com/uploads/images/original_untouched/501/1253519.jpg",
        "official_site": "http://www.amc.com/shows/breaking-bad",
        "url": "https://www.tvmaze.com/shows/169/breaking-bad",
        "source": "tvmaze",
        "license": "CC-BY-SA 4.0 (TVmaze)"
      },
      {
        "ids": {
          "tvmaze": 27845,
          "imdb": "tt2387761",
          "thetvdb": 356427
        },
        "type": "tv",
        "title": "Breaking Bad: Original Minisodes",
        "year": 2009,
        "premiered": "[redacted-phone]",
        "ended": "[redacted-phone]",
        "genres": [
          "Comedy",
          "Crime"
        ],
        "runtime": 5,
        "status": "Ended",
        "language": "English",
        "show_type": "Scripted",
        "overview": "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 Day\". Go inside Jesse's band TwaughtHammer as he and Badger make a behind-the-music documentary, and sing along to the full music video for their song \"Fallacies\". Finally, watch Marie discuss politics and patriotism in her personal video diary, \"Marie's Confession\".",
        "rating": {
          "tvmaze": 7
        },
        "network": "AMC",
        "country": "United States",
        "schedule": {
          "time": ""
        },
        "poster": "https://static.tvmaze.com/uploads/images/original_untouched/216/540867.jpg",
        "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).",
        "url": "https://www.tvmaze.com/shows/27845/breaking-bad-original-minisodes",
        "source": "tvmaze",
        "license": "CC-BY-SA 4.0 (TVmaze)"
      },
      {
        "ids": {
          "tvmaze": 1003,
          "imdb": "tt3115468",
          "thetvdb": 272219,
          "tvrage": 36082
        },
        "type": "tv",
        "title": "Talking Bad",
        "year": 2013,
        "premiered": "[redacted-phone]",
        "ended": "[redacted-phone]",
        "runtime": 30,
        "status": "Ended",
        "language": "English",
        "show_type": "Talk Show",
        "overview": "Talking Bad features Hardwick spending time with fans, actors, producers and tv enthusiasts, recapping the most recent Breaking Bad episode, and taking questions and comments from viewers. Fans may continue to engage with the after-show following the on-air conclusion, online, at amc.com for more videos, weekly polls and photo galleries of the guests featured on the series.",
        "network": "AMC",
        "country": "United States",
        "schedule": {
          "time": "23:05",
          "days": [
            "[trimmed-depth]"
          ]
        },
        "poster": "https://static.tvmaze.com/uploads/images/original_untouched/6/16586.jpg",
        "url": "https://www.tvmaze.com/shows/1003/talking-bad",
        "source": "tvmaze",
        "license": "CC-BY-SA 4.0 (TVmaze)"
      }
    ]
  }
}
Actions

What the Movies & TV API does

ActionDescriptionConcrete use caseKey params
searchsearch titles (type=multi|movie|tv|streaming)Content platforms call search to search titles (type=multi|movie|tv|streaming).query, type, limit, year, country, ...
detailunified title detail (tv→TVmaze, movie→TMDB depth + JustWatch offers)Research tools call detail to get unified title detail (tv→TVmaze, movie→TMDB depth + JustWatch offers).id, type, id_type, country, include_streaming, ...
episodesTV episodes (optionally one season)Community analysts call episodes to get tV episodes (optionally one season).id, id_type, season, specials
castcast (tv→TVmaze, movie→TMDB)Media monitors call cast to get cast (tv→TVmaze, movie→TMDB).id, type, id_type
crewcrew (tv→TVmaze, movie→TMDB)Content platforms call crew to get crew (tv→TVmaze, movie→TMDB).id, type, id_type
akasalternative titles (tv→TVmaze, movie→TMDB)Research tools call akas to get alternative titles (tv→TVmaze, movie→TMDB).id, type, id_type
scheduleTV broadcast (kind=tv) or streaming-premiere (kind=web) calendarCommunity analysts call schedule to get tV broadcast (kind=tv) or streaming-premiere (kind=web) calendar.country, date, kind
streamingwhere-to-watch offers via JustWatch (query/node_id/imdb/tmdb)Media monitors call streaming to get where-to-watch offers via JustWatch (query/node_id/imdb/tmdb).query, id, id_type, node_id, country, ...
peopleperson search or detail (tv→TVmaze, movie→TMDB)Content platforms call people to get person search or detail (tv→TVmaze, movie→TMDB).query, id, type
lookupcross-resolve imdb↔tmdb↔tvmaze idsResearch tools call lookup to get cross-resolve imdb↔tmdb↔tvmaze ids.imdb_id, tmdb_id, tvmaze_id, id, id_type, ...
genresTMDB genre reference (movie|tv)Community analysts call genres to get tMDB genre reference (movie|tv).type
countriesstreaming services available in a country (JustWatch)Media monitors call countries to get streaming services available in a country (JustWatch).country
new_titlesrecently added/changed on streaming (≈ catalog changes)Content platforms call new_titles to get recently added/changed on streaming (≈ catalog changes).date, country, limit, object_types, packages
chartsRanked title charts: most-popular / top-rated / upcoming / now-playing / on-the-air / trending — for movies, TV or both. A `language` filter turns top-rated/popular into the per-language charts (e.g. top-rated Tamil/Telugu/Hindi); `region` localises upcoming/now-playing.Research tools call charts to get ranked title charts.chart, language, region, page, limit
similarTitles similar to / recommended for a given movie or TV show (TMDB recommendations, falling back to similar). Accepts a TMDB id or an IMDb tt… id.Community analysts call similar to get titles similar to / recommended for a given movie or TV show (TMDB recommendations, falling b….id, type, limit
creditsA person's full filmography (combined movie + TV credits) by TMDB person id or by name — every title they were cast or crew on, newest first, with their character/job.Media monitors call credits to get a person's full filmography (combined movie + TV credits) by TMDB person id or by name.person_id, name, limit
discoverBrowse the catalog with filters — find movies or TV by genre, year range, minimum rating, runtime, original language, cast/crew, keyword and where-to-stream provider, sorted however you like. The 'explore like a real user' surface.Content platforms call discover to get browse the catalog with filters.type, genres, year, year_gte, year_lte, ...
reviewsUser reviews for a movie or TV show (author, star rating, full text), paginated.Research tools call reviews to get user reviews for a movie or TV show (author, star rating, full text), paginated..id, type, page
imagesAll artwork for a title — posters, backdrops and (TV) episode stills with resolutions and language tags.Community analysts call images to get all artwork for a title.id, type, limit
videosTrailers, teasers and clips for a movie or TV show (YouTube keys + ready-to-play URLs).Media monitors call videos to get trailers, teasers and clips for a movie or TV show (YouTube keys + ready-to-play URLs)..id, type
watch_providersWhere to stream/rent/buy a title (TMDB/JustWatch data) — pass a country for that region's offers, or omit it to get every region.Content platforms call watch_providers to get where to stream/rent/buy a title (TMDB/JustWatch data).id, type, country
seasonFull episode list for one season of a TV show — episode titles, overviews, air dates, ratings and stills (TMDB).Research tools call season to get full episode list for one season of a TV show.id, season, type
episodeOne TV episode in depth — overview, air date, rating, guest stars and crew (TMDB).Community analysts call episode to get one TV episode in depth.id, season, episode
Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/movies-tv/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"breaking bad","type":"tv"}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.movies-tv.search with {"query":"breaking bad","type":"tv"}.
Use cases

Who uses this API and why

  • Recommendation engines call search and detail to build catalogs cross-linked to IMDb and TMDb.
  • TV apps use episodes and schedule to track seasons and airings.
  • Media research uses cast and crew to assemble filmographies.
FAQ

Questions developers ask before integrating

What is the Movies & TV API?

Movies & TV API is a ReefAPI endpoint group for film and series details, cast and ratings. It returns live JSON through POST requests under /movies-tv/v1.

Is the Movies & TV API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Movies & TV calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Movies & TV login or account?

No login to Movies & TV is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Movies & TV data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Movies & TV API use?

Movies & TV actions currently cost 1-2 credits per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.

Can I call Movies & TV from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call movies-tv actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Movies & TV API a Movies & TV scraper?

It is the managed alternative to a DIY Movies & TV scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same film and series details, cast and ratings back as clean JSON.

Why does my Movies & TV scraper keep getting blocked?

Most Movies & TV scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.

docs / movies-tv

Movies & TV

Film and series details, cast and ratings.

base /movies-tv/v123 endpoints
post/movies-tv/v1/detail2 credits

unified title detail (tv→TVmaze, movie→TMDB depth + JustWatch offers)

ParameterAllowed / rangeDescription
idrequiredTitle id. By default a TVmaze id (TV) or TMDB id (movie); an imdb id (tt0903747) is auto-detected. Set id_type to be explicit.
typeoptionalmovie · tvWhether the id/query is a movie or a TV show. Defaults to TV unless the id is a tmdb id or looks like a movie.
id_typeoptionaltvmaze · tmdb · imdbHow to interpret `id`. Auto-detected (imdb if it starts with 'tt', else tvmaze for TV / tmdb for movie) when omitted.
country = USoptionalJustWatch market — ISO-3166-1 alpha-2 (~140 supported). Controls streaming offers / services / new-titles region.
include_streaming = trueoptionalMerge JustWatch where-to-watch offers into the detail record.
languageoptionalDisplay locale for movie titles/overview (TMDB; e.g. de-DE, fr-FR, ja-JP).
Try in playground →
post/movies-tv/v1/episodes1 credit

TV episodes (optionally one season)

ParameterAllowed / rangeDescription
idrequiredTitle id. By default a TVmaze id (TV) or TMDB id (movie); an imdb id (tt0903747) is auto-detected. Set id_type to be explicit.
id_typeoptionaltvmaze · tmdb · imdbHow to interpret `id`. Auto-detected (imdb if it starts with 'tt', else tvmaze for TV / tmdb for movie) when omitted.
seasonoptionalLimit to one season number (omit for all).
specials = falseoptionalInclude special (non-numbered) episodes.
Try in playground →
post/movies-tv/v1/cast1 credit

cast (tv→TVmaze, movie→TMDB)

ParameterAllowed / rangeDescription
idrequiredTitle id. By default a TVmaze id (TV) or TMDB id (movie); an imdb id (tt0903747) is auto-detected. Set id_type to be explicit.
typeoptionalmovie · tvWhether the id/query is a movie or a TV show. Defaults to TV unless the id is a tmdb id or looks like a movie.
id_typeoptionaltvmaze · tmdb · imdbHow to interpret `id`. Auto-detected (imdb if it starts with 'tt', else tvmaze for TV / tmdb for movie) when omitted.
Try in playground →
post/movies-tv/v1/crew1 credit

crew (tv→TVmaze, movie→TMDB)

ParameterAllowed / rangeDescription
idrequiredTitle id. By default a TVmaze id (TV) or TMDB id (movie); an imdb id (tt0903747) is auto-detected. Set id_type to be explicit.
typeoptionalmovie · tvWhether the id/query is a movie or a TV show. Defaults to TV unless the id is a tmdb id or looks like a movie.
id_typeoptionaltvmaze · tmdb · imdbHow to interpret `id`. Auto-detected (imdb if it starts with 'tt', else tvmaze for TV / tmdb for movie) when omitted.
Try in playground →
post/movies-tv/v1/akas1 credit

alternative titles (tv→TVmaze, movie→TMDB)

ParameterAllowed / rangeDescription
idrequiredTitle id. By default a TVmaze id (TV) or TMDB id (movie); an imdb id (tt0903747) is auto-detected. Set id_type to be explicit.
typeoptionalmovie · tvWhether the id/query is a movie or a TV show. Defaults to TV unless the id is a tmdb id or looks like a movie.
id_typeoptionaltvmaze · tmdb · imdbHow to interpret `id`. Auto-detected (imdb if it starts with 'tt', else tvmaze for TV / tmdb for movie) when omitted.
Try in playground →
post/movies-tv/v1/schedule1 credit

TV broadcast (kind=tv) or streaming-premiere (kind=web) calendar

ParameterAllowed / rangeDescription
country = USoptionalJustWatch market — ISO-3166-1 alpha-2 (~140 supported). Controls streaming offers / services / new-titles region.
dateoptionalDate as YYYY-MM-DD.
kind = tvoptionaltv · web · streamingWhich calendar. Any non-web value is treated as the TV broadcast schedule.
Try in playground →
post/movies-tv/v1/streaming1 credit

where-to-watch offers via JustWatch (query/node_id/imdb/tmdb)

ParameterAllowed / rangeDescription
queryoptionalFree-text title/person search keywords.
idoptionalTitle id. By default a TVmaze id (TV) or TMDB id (movie); an imdb id (tt0903747) is auto-detected. Set id_type to be explicit.
id_typeoptionaltvmaze · tmdb · imdbHow to interpret `id`. Auto-detected (imdb if it starts with 'tt', else tvmaze for TV / tmdb for movie) when omitted.
node_idoptionalJustWatch node id (tm…/ts…) — fetches offers directly without a search.
country = USoptionalJustWatch market — ISO-3166-1 alpha-2 (~140 supported). Controls streaming offers / services / new-titles region.
object_typesoptionalMOVIE · SHOWRestrict JustWatch results to these node types (MOVIE / SHOW).
titleoptionalExact title to match when resolving by imdb/tmdb id.
yearoptionalRelease-year filter (movie search / streaming match).
Try in playground →
post/movies-tv/v1/people1 credit

person search or detail (tv→TVmaze, movie→TMDB)

ParameterAllowed / rangeDescription
queryoptionalFree-text title/person search keywords.
idoptionalTitle id. By default a TVmaze id (TV) or TMDB id (movie); an imdb id (tt0903747) is auto-detected. Set id_type to be explicit.
typeoptionalmovie · tvWhether the id/query is a movie or a TV show. Defaults to TV unless the id is a tmdb id or looks like a movie.
Try in playground →
post/movies-tv/v1/lookup1 credit

cross-resolve imdb↔tmdb↔tvmaze ids

ParameterAllowed / rangeDescription
imdb_idoptionalIMDb id to resolve (tt…). Provide any ONE id.
tmdb_idoptionalTMDB id to resolve.
tvmaze_idoptionalTVmaze id to resolve.
idoptionalTitle id. By default a TVmaze id (TV) or TMDB id (movie); an imdb id (tt0903747) is auto-detected. Set id_type to be explicit.
id_typeoptionaltvmaze · tmdb · imdbHow to interpret `id`. Auto-detected (imdb if it starts with 'tt', else tvmaze for TV / tmdb for movie) when omitted.
typeoptionalmovie · tvWhether the id/query is a movie or a TV show. Defaults to TV unless the id is a tmdb id or looks like a movie.
Try in playground →
post/movies-tv/v1/genresfree

TMDB genre reference (movie|tv)

ParameterAllowed / rangeDescription
typeoptionalmovie · tvWhether the id/query is a movie or a TV show. Defaults to TV unless the id is a tmdb id or looks like a movie.
Try in playground →
post/movies-tv/v1/countriesfree

streaming services available in a country (JustWatch)

ParameterAllowed / rangeDescription
country = USoptionalJustWatch market — ISO-3166-1 alpha-2 (~140 supported). Controls streaming offers / services / new-titles region.
Try in playground →
post/movies-tv/v1/new_titles1 credit

recently added/changed on streaming (≈ catalog changes)

ParameterAllowed / rangeDescription
daterequiredDate as YYYY-MM-DD (required — the catalog-change day to report).
country = USoptionalJustWatch market — ISO-3166-1 alpha-2 (~140 supported). Controls streaming offers / services / new-titles region.
limit = 20optional1–Max results to return.
object_typesoptionalMOVIE · SHOWRestrict JustWatch results to these node types (MOVIE / SHOW).
packagesoptionalRestrict to these JustWatch provider technical names (e.g. nfx=Netflix).
Try in playground →
post/movies-tv/v1/charts1 credit

Ranked title charts: most-popular / top-rated / upcoming / now-playing / on-the-air / trending — for movies, TV or both. A `language` filter turns top-rated/popular into the per-language charts (e.g. top-rated Tamil/Telugu/Hindi); `region` localises upcoming/now-playing.

ParameterAllowed / rangeDescription
chartoptionalpopular_movies · popular_tv · top_rated_movies · top_rated_tv · upcoming_movies · now_playing_movies · on_the_air_tv · trending_movies · trending_tv · trending_allWhich chart to return.
languageoptionalISO 639-1 original-language filter (e.g. ta=Tamil, te=Telugu, hi=Hindi, en=English). Turns popular/top-rated into per-language charts.
regionoptionalISO 3166-1 region to localise upcoming/now-playing.
page = 1optional1–TMDB result page (movie/multi search only).
limit = 20optional1–Max results to return.
Try in playground →
post/movies-tv/v1/similar1 credit

Titles similar to / recommended for a given movie or TV show (TMDB recommendations, falling back to similar). Accepts a TMDB id or an IMDb tt… id.

ParameterAllowed / rangeDescription
idrequiredTitle id. By default a TVmaze id (TV) or TMDB id (movie); an imdb id (tt0903747) is auto-detected. Set id_type to be explicit.
typeoptionalmovie · tvWhether the id/query is a movie or a TV show. Defaults to TV unless the id is a tmdb id or looks like a movie.
limit = 20optional1–Max results to return.
Try in playground →
post/movies-tv/v1/credits1 credit

A person's full filmography (combined movie + TV credits) by TMDB person id or by name — every title they were cast or crew on, newest first, with their character/job.

ParameterAllowed / rangeDescription
person_idoptionalTMDB person id (omit if passing `name`).
nameoptionalPerson name to search (used when `person_id` is omitted).
limit = 40optional1–Max results to return.
Try in playground →
post/movies-tv/v1/discover1 credit

Browse the catalog with filters — find movies or TV by genre, year range, minimum rating, runtime, original language, cast/crew, keyword and where-to-stream provider, sorted however you like. The 'explore like a real user' surface.

ParameterAllowed / rangeDescription
type = movieoptionalmovie · tvWhether to browse/return movies or TV shows.
genresoptionalGenre filter — names ('Action','Comedy') or TMDB ids (28,878), comma-separated. See the `genres` action for the full list.
yearoptionalExact release/first-air year.
year_gteoptionalEarliest year (inclusive).
year_lteoptionalLatest year (inclusive).
rating_gteoptionalMinimum TMDB rating 0-10 (auto-applies a 50-vote floor to drop 1-vote outliers).
runtime_gteoptionalMinimum runtime in minutes.
runtime_lteoptionalMaximum runtime in minutes.
languageoptionalOriginal-language filter, ISO 639-1 (e.g. ko=Korean, ja=Japanese, hi=Hindi, en=English).
regionoptionalISO 3166-1 region for release-window localisation.
with_castoptionalTMDB person id(s) who must appear in the cast (comma-separated).
sort_by = popularity.descoptionalpopularity.desc · popularity.asc · vote_average.desc · vote_average.asc · primary_release_date.desc · primary_release_date.asc · revenue.descResult ordering.
page = 1optional1–TMDB result page (movie/multi search only).
localeoptionalDisplay language for titles/overviews (e.g. de-DE, ja-JP).
Try in playground →
post/movies-tv/v1/reviews1 credit

User reviews for a movie or TV show (author, star rating, full text), paginated.

ParameterAllowed / rangeDescription
idrequiredTMDB id (e.g. 27205) OR an IMDb id (tt1375666) — auto-resolved.
type = movieoptionalmovie · tvWhether to browse/return movies or TV shows.
page = 1optional1–TMDB result page (movie/multi search only).
Try in playground →
post/movies-tv/v1/images1 credit

All artwork for a title — posters, backdrops and (TV) episode stills with resolutions and language tags.

ParameterAllowed / rangeDescription
idrequiredTMDB id (e.g. 27205) OR an IMDb id (tt1375666) — auto-resolved.
type = movieoptionalmovie · tvWhether to browse/return movies or TV shows.
limit = 20optional1–Max results to return.
Try in playground →
post/movies-tv/v1/videos1 credit

Trailers, teasers and clips for a movie or TV show (YouTube keys + ready-to-play URLs).

ParameterAllowed / rangeDescription
idrequiredTMDB id (e.g. 27205) OR an IMDb id (tt1375666) — auto-resolved.
type = movieoptionalmovie · tvWhether to browse/return movies or TV shows.
Try in playground →
post/movies-tv/v1/watch_providers1 credit

Where to stream/rent/buy a title (TMDB/JustWatch data) — pass a country for that region's offers, or omit it to get every region.

ParameterAllowed / rangeDescription
idrequiredTMDB id (e.g. 27205) OR an IMDb id (tt1375666) — auto-resolved.
type = movieoptionalmovie · tvWhether to browse/return movies or TV shows.
country = USoptionalJustWatch market — ISO-3166-1 alpha-2 (~140 supported). Controls streaming offers / services / new-titles region.
Try in playground →
post/movies-tv/v1/season1 credit

Full episode list for one season of a TV show — episode titles, overviews, air dates, ratings and stills (TMDB).

ParameterAllowed / rangeDescription
idrequiredTMDB id (e.g. 27205) OR an IMDb id (tt1375666) — auto-resolved.
seasonrequiredSeason number.
type = tvoptionaltvAlways tv.
Try in playground →
post/movies-tv/v1/episode1 credit

One TV episode in depth — overview, air date, rating, guest stars and crew (TMDB).

ParameterAllowed / rangeDescription
idrequiredTMDB id (e.g. 27205) OR an IMDb id (tt1375666) — auto-resolved.
seasonrequiredSeason number.
episoderequiredEpisode number within the season.
Try in playground →