Skip to content

Movie and TV details, filmographies and episode ratings

IMDb returns movie, TV, person, episode, chart and Parents Guide details, including available weekly rank changes; missing details are null, and unaired or unrated episodes lack ratings.

Get episode ratings

List every episode of an IMDb TV series in season and episode order, with air dates, ratings, votes, plots and links. Optionally select one season; unrated or unaired episodes have no rating.

Your information

Season number, for example 2. Default 0 means all seasons.

TV series name, IMDb title link, or title ID, for example Breaking Bad.

1 credit per run

Example results

Imdb Link
imdb.com
Year Range
2008–2013
Series Title
Breaking Bad
Number of Seasons
5
Episodes
Episodes
Episode TitleAir DateEpisode IDShort PlotImdb RatingEpisode LinkSeason NumberEpisode NumberNumber of Votes
Live Free or Die
2012-07-15
tt2081647
After a deadly showdown, Walt and Jesse race to destroy evidence that could expose them, drawing Mike into a daring plan, while Skyler faces a frightening new reality at home.
9.2
5
1
66,283
Madrigal
2012-07-22
tt2301457
As Walt and Jesse seek Mike's help to rebuild their business, Gus's former associates face mounting scrutiny, while a Madrigal executive scrambles to contain the fallout.
8.8
5
2
58,669
Hazard Pay
2012-07-29
tt2301459
Walt, Jesse, and Mike devise an unconventional way to restart production, but disputes over money strain their new partnership, while Skyler struggles with Walt's return home.
8.8
5
3
58,155
Fifty-One
2012-08-05
tt2301461
As Walt celebrates his 51st birthday, Skyler's mounting fear brings their conflict to a breaking point, while Mike and Jesse investigate a threat to their fragile new operation.
8.8
5
4
58,487
Dead Freight
2012-08-12
tt2301463
Walt, Jesse and Mike devise an audacious plan to steal a vital chemical shipment, but logistical obstacles and mounting risks threaten their fragile new operation.
9.6
5
5
88,415
Buyout
2012-08-19
tt2301465
A lucrative buyout offer divides Walt, Jesse and Mike over the future of their operation, while an uneasy encounter at Walt's home exposes the widening divide between his two worlds.
9
5
6
60,911
Say My Name
2012-08-26
tt2301467
As Walt makes a bold bid to expand the business, Mike plans his exit and Jesse questions his future, while mounting DEA pressure threatens their fragile partnership.
9.6
5
7
84,361
Gliding Over All
2012-09-02
tt2301469
As Walt moves to secure and expand his empire, he confronts dangerous loose ends and strained relationships, while Skyler reveals the staggering scale of what he has built.
9.5
5
8
74,767
Blood Money
2013-08-11
tt2301471
As Walt settles into a quieter life, Hank reels from a troubling discovery, Jesse's guilt takes a reckless turn, and Lydia seeks help with a growing problem.
9.4
5
9
70,477
Buried
2013-08-18
tt2301443
As Hank presses Skyler for answers, Walt scrambles to safeguard his family and fortune, while Jesse's increasingly erratic behavior draws unwanted attention.
9.2
5
10
64,851
Confessions
2013-08-25
tt2301445
As Hank searches for a way to build his case against Walt, Walt moves to protect himself and his family, while Jesse considers disappearing for good.
9.6
5
11
82,422
Rabid Dog
2013-09-01
tt2301447
As Jesse's anger threatens to expose everything, Walt scrambles to contain the fallout, while Hank pursues a risky new strategy and Skyler urges a drastic solution.
9.1
5
12
69,735
To'hajiilee
2013-09-08
tt2301449
As Jesse and Hank put a daring plan into motion, Walt scrambles to protect his hidden fortune, drawing dangerous allies and enemies toward a volatile confrontation.
9.7
5
13
130,431
Ozymandias
2013-09-15
tt2301451
In the wake of a devastating confrontation, Walt scrambles to protect his family and salvage what remains of his empire as years of lies and violence finally come crashing home.
9.5
5
14
508,902
Granite State
2013-09-22
tt2301453
As Walt adjusts to an isolated life in hiding, he searches for a way to secure his family's future, while Jesse endures a desperate situation and Skyler faces pressure from the law and dangerous enemies.
9.6
5
15
125,553
Felina
2013-09-29
tt2301455
Walt returns to Albuquerque to settle unfinished business, secure his family's future, and confront the consequences of the empire he built.
9.8
5
16
297,625
Example data · Run in Studio for fresh results.

Choose an action

About IMDb

IMDb's Get movie or show returns title details from a title, link, or ID; year can distinguish matches.

Get person takes a person's name, IMDb link, or ID; List top charts takes a chart and optional result count.

Get episode ratings takes a series and optional season; Get parents guide takes a title, link, or ID, with an optional year.

Built by Fous from imdb.com and checked automatically; it last passed a check on Sep 30, 2026. Fous is not affiliated with IMDb.

Actions

Get episode ratings

1 credit per run

List every episode of an IMDb TV series in season and episode order, with air dates, ratings, votes, plots and links. Optionally select one season; unrated or unaired episodes have no rating.

What you provide

FieldTypeRequiredDescription
SeasonseasonNumberOptionalSeason number, for example 2. Default 0 means all seasons.Example: 2
SeriesseriesTextRequiredTV series name, IMDb title link, or title ID, for example Breaking Bad.Example: The Office

What you get

FieldTypeDescription
EpisodesepisodesList
Air Dateepisodes[].air_dateDateExample: 2012-07-15
Episode IDepisodes[].episode_idTextExample: tt2081647
Short Plotepisodes[].short_plotTextExample: After a deadly showdown, Walt and Jesse race to destroy evidence that could…
Imdb Ratingepisodes[].imdb_ratingNumberIMDb rating out of 10; null if unrated or unaired.Example: 9.2
Episode Linkepisodes[].episode_linkTextExample: https://www.imdb.com/title/tt2081647/
Episode Titleepisodes[].episode_titleTextExample: Live Free or Die
Season Numberepisodes[].season_numberNumberSeason number, if known.Example: 5
Episode Numberepisodes[].episode_numberNumberEpisode number within the season, if known.Example: 1
Number of Votesepisodes[].number_of_votesNumberExample: 66283
Imdb Linkimdb_linkTextExample: https://www.imdb.com/title/tt0903747/
Year Rangeyear_rangeTextExample: 2008–2013
Series Titleseries_titleTextExample: Breaking Bad
Number of Seasonsnumber_of_seasonsNumberExample: 5

Example result

For Season: 5, Series: https://www.imdb.com/title/tt0903747/

JSON
{
  "episodes": [
    {
      "air_date": "2012-07-15",
      "episode_id": "tt2081647",
      "short_plot": "After a deadly showdown, Walt and Jesse race to destroy evidence that could expose them, drawing Mike into a daring plan, while Skyler faces a frightening new reality at home.",
      "imdb_rating": 9.2,
      "episode_link": "https://www.imdb.com/title/tt2081647/",
      "episode_title": "Live Free or Die",
      "season_number": 5,
      "episode_number": 1,
      "number_of_votes": 66283
    },
    {
      "air_date": "2012-07-22",
      "episode_id": "tt2301457",
      "short_plot": "As Walt and Jesse seek Mike's help to rebuild their business, Gus's former associates face mounting scrutiny, while a Madrigal executive scrambles to contain the fallout.",
      "imdb_rating": 8.8,
      "episode_link": "https://www.imdb.com/title/tt2301457/",
      "episode_title": "Madrigal",
      "season_number": 5,
      "episode_number": 2,
      "number_of_votes": 58669
    },
    {
      "air_date": "2012-07-29",
      "episode_id": "tt2301459",
      "short_plot": "Walt, Jesse, and Mike devise an unconventional way to restart production, but disputes over money strain their new partnership, while Skyler struggles with Walt's return home.",
      "imdb_rating": 8.8,
      "episode_link": "https://www.imdb.com/title/tt2301459/",
      "episode_title": "Hazard Pay",
      "season_number": 5,
      "episode_number": 3,
      "number_of_votes": 58155
    }
  ],
  "imdb_link": "https://www.imdb.com/title/tt0903747/",
  "year_range": "2008–2013",
  "series_title": "Breaking Bad",
  "number_of_seasons": 5
}

Get movie or show

1 credit per run

Get a movie or TV show’s IMDb details from its name, link, or title ID. A year can distinguish titles with the same name; unavailable details are null.

What you provide

FieldTypeRequiredDescription
YearyearNumberOptionalRelease or first aired year to distinguish matching names, e.g. 2023.Example: 2023
TitletitleTextRequiredMovie or show name, IMDb title link, or title ID, e.g. Oppenheimer or tt15398776.Example: Breaking Bad

What you get

FieldTypeDescription
CastcastList
Actorcast[].actorTextExample: Bryan Cranston
Charactercast[].characterTextExample: Walter White
TypetypeTextExample: TV series
YearyearNumberExample: 2008
TitletitleTextExample: Breaking Bad
BudgetbudgetDetails
Amountbudget.amountNumberExample: 100000000
Currencybudget.currencyTextExample: USD
GenresgenresList
RuntimeruntimeTextExample: 48 min
WriterswritersList
CountriescountriesList
DirectorsdirectorsList
Imdb Linkimdb_linkTextExample: https://www.imdb.com/title/tt0903747/
LanguageslanguagesList
MetascoremetascoreNumberExample: 90
Age Ratingage_ratingTextExample: TV-MA
Vote Countvote_countNumberExample: 2682966
Imdb Ratingimdb_ratingNumberIMDb user rating out of 10.Example: 9.5
Years Airedyears_airedTextExample: 2008–2013
Plot Summaryplot_summaryTextExample: A chemistry teacher diagnosed with inoperable lung cancer turns to…
Release Daterelease_dateDateExample: 2008-01-20
Imdb Title IDimdb_title_idTextExample: tt0903747
Awards Summaryawards_summaryTextExample: Won 16 Primetime Emmys. 172 wins and 269 nominations total.
Runtime (minutes)runtime_minutesNumberExample: 48
Worldwide Grossworldwide_grossDetails
Amountworldwide_gross.amountNumberExample: 975811333
Currencyworldwide_gross.currencyTextExample: USD
Poster Image Linkposter_image_linkTextExample: https://m.media-amazon.com/images/M/MV5BMzU5ZGYzNmQtMTdhYy00OGRiLTg0NmQtYjVjNzl…

Example result

For Title: Breaking Bad

JSON
{
  "cast": [
    {
      "actor": "Bryan Cranston",
      "character": "Walter White"
    },
    {
      "actor": "Aaron Paul",
      "character": "Jesse Pinkman"
    },
    {
      "actor": "Anna Gunn",
      "character": "Skyler White"
    }
  ],
  "type": "TV series",
  "year": 2008,
  "title": "Breaking Bad",
  "budget": null,
  "genres": [
    "Crime",
    "Drama",
    "Thriller"
  ],
  "runtime": "48 min",
  "writers": [
    "Vince Gilligan"
  ],
  "countries": [
    "United States"
  ],
  "directors": [],
  "imdb_link": "https://www.imdb.com/title/tt0903747/",
  "languages": [
    "English",
    "Spanish"
  ],
  "metascore": null,
  "age_rating": "TV-MA",
  "vote_count": 2682966,
  "imdb_rating": 9.5,
  "years_aired": "2008–2013",
  "plot_summary": "A chemistry teacher diagnosed with inoperable lung cancer turns to manufacturing and selling methamphetamine with a former student to secure his family's future.",
  "release_date": "2008-01-20",
  "imdb_title_id": "tt0903747",
  "awards_summary": "Won 16 Primetime Emmys. 172 wins and 269 nominations total.",
  "runtime_minutes": 48,
  "worldwide_gross": null,
  "poster_image_link": "https://m.media-amazon.com/images/M/MV5BMzU5ZGYzNmQtMTdhYy00OGRiLTg0NmQtYjVjNzliZTg1ZGE4XkEyXkFqcGc@._V1_.jpg"
}

Get parents guide

1 credit per run

Get age certifications and non-spoiler Parents Guide summaries for a movie or show by title, link, or IMDb ID. A year can identify a specific release.

What you provide

FieldTypeRequiredDescription
YearyearNumberOptionalRelease or first-air year to select a matching title, such as 2016.Example: 1995
TitletitleTextRequiredMovie or show name, IMDb title link, or title ID, such as Deadpool or tt1431045.Example: Deadpool

What you get

FieldType
YearyearNumber
TitletitleText
Imdb Linkimdb_linkText
CategoriescategoriesList
Categorycategories[].categoryText
Severitycategories[].severityText
Imdb Linkcategories[].imdb_linkText
Mild Votescategories[].mild_votesNumber
None Votescategories[].none_votesNumber
Severe Votescategories[].severe_votesNumber
Moderate Votescategories[].moderate_votesNumber
Example Descriptionscategories[].example_descriptionsList
Age Certificationsage_certificationsList
Notesage_certifications[].notesText
Ratingage_certifications[].ratingText
Countryage_certifications[].countryText

Get person

1 credit per run

Find a film person by name or IMDb link or ID and get their biography, awards, and filmography. Credits exclude self-appearances, archive footage, and thanks.

What you provide

FieldTypeRequiredDescription
NamenameTextRequiredThe person’s name, IMDb person link, or person ID, for example Cillian Murphy.Example: https://www.imdb.com/name/nm0634240/
Max Creditsmax_creditsNumberOptionalMaximum number of credits to return, for example 50.Example: 70

What you get

FieldTypeDescription
NamenameTextExample: Christopher Nolan
Imdb Linkimdb_linkTextExample: https://www.imdb.com/name/nm0634240/
Person IDperson_idTextExample: nm0634240
Birth Datebirth_dateDateExample: 1970-07-30
BirthplacebirthplaceTextExample: London, England, UK
Death Datedeath_dateDate
Photo Linkphoto_linkTextExample: https://m.media-amazon.com/images/M/MV5BNjE3NDQyOTYyMV5BMl5BanBnXkFtZTcwODcyODU…
FilmographyfilmographyList
Typefilmography[].typeTextExample: Movie
Yearfilmography[].yearNumberExample: 2026
Titlefilmography[].titleTextExample: The Odyssey
Title IDfilmography[].title_idTextExample: tt33764258
Imdb Linkfilmography[].imdb_linkTextExample: https://www.imdb.com/title/tt33764258/
Imdb Ratingfilmography[].imdb_ratingNumberExample: 8.4
Role or Jobfilmography[].role_or_jobTextExample: produced by; written for the screen by; Director; writer: "When I'm Home"
Awards Summaryawards_summaryTextExample: 2 Oscar wins; 6 Oscar nominations; 235 total wins; 302 other nominations
Short Biographyshort_biographyTextExample: Best known for his cerebral, often nonlinear, storytelling, acclaimed Academy…
Known for Titlesknown_for_titlesList
Main Professionsmain_professionsList

Example result

For Name: https://www.imdb.com/name/nm0634240/, Max Credits: 70

JSON
{
  "name": "Christopher Nolan",
  "imdb_link": "https://www.imdb.com/name/nm0634240/",
  "person_id": "nm0634240",
  "birth_date": "1970-07-30",
  "birthplace": "London, England, UK",
  "death_date": null,
  "photo_link": "https://m.media-amazon.com/images/M/MV5BNjE3NDQyOTYyMV5BMl5BanBnXkFtZTcwODcyODU2Mw@@._V1_.jpg",
  "filmography": [
    {
      "type": "movie",
      "year": 2026,
      "title": "The Odyssey",
      "title_id": "tt33764258",
      "imdb_link": "https://www.imdb.com/title/tt33764258/",
      "imdb_rating": 8.4,
      "role_or_job": "produced by; written for the screen by; Director; writer: \"When I'm Home\""
    },
    {
      "type": "movie",
      "year": 2024,
      "title": "Sanatorium Under the Sign of the Hourglass",
      "title_id": "tt33069917",
      "imdb_link": "https://www.imdb.com/title/tt33069917/",
      "imdb_rating": 5.9,
      "role_or_job": "presenter"
    },
    {
      "type": "movie",
      "year": 2023,
      "title": "Oppenheimer",
      "title_id": "tt15398776",
      "imdb_link": "https://www.imdb.com/title/tt15398776/",
      "imdb_rating": 8.2,
      "role_or_job": "produced by; written for the screen by; Director"
    }
  ],
  "awards_summary": "2 Oscar wins; 6 Oscar nominations; 235 total wins; 302 other nominations",
  "short_biography": "Best known for his cerebral, often nonlinear, storytelling, acclaimed Academy Award winner writer/director/producer Sir Christopher Nolan CBE was born in London, England. Over the course of more than …",
  "known_for_titles": [
    "Tenet",
    "The Prestige",
    "Interstellar"
  ],
  "main_professions": [
    "Producer",
    "Writer",
    "Director"
  ]
}

List top charts

1 credit per run

List titles in an IMDb movie or TV chart, with ratings, votes, runtime, age rating and weekly rank movement where available. Popular charts contain up to 100 titles.

What you provide

FieldTypeRequiredDescription
ChartchartTextOptionalChart to list, for example top_250_movies.Example: Top 250 tv shows
Max Resultsmax_resultsNumberOptionalMaximum number of titles, for example 50. Popular charts have at most 100 titles.Example: 5

What you get

FieldTypeDescription
TitlestitlesListTitles in chart order.
Ranktitles[].rankNumberPosition in the chosen chart.Example: 1
Yeartitles[].yearNumberFirst release year, if available.Example: 2008
Titletitles[].titleTextMovie or show title.Example: Breaking Bad
Votestitles[].votesNumberNumber of IMDb rating votes, if available.Example: 2682966
Runtimetitles[].runtimeTextRuntime, such as 2 h 22 min, if available.Example: 48 min
Title IDtitles[].title_idTextIMDb title identifier.Example: tt0903747
Imdb Linktitles[].imdb_linkTextIMDb page for this title.Example: https://www.imdb.com/title/tt0903747/
Age Ratingtitles[].age_ratingTextContent rating, such as R or TV-MA, if available.Example: TV-MA
Imdb Ratingtitles[].imdb_ratingNumberIMDb audience rating out of 10, if available.Example: 9.5
Runtime (minutes)titles[].runtime_minutesNumberRuntime in minutes, if available.Example: 48
Rank Change Since Last Weektitles[].rank_change_since_last_weekNumberWeekly popularity chart rank change: positive means moved up, negative means moved down, zero means unchanged; null when unavailable or not a popularity chart.Example: 0

Example result

For Chart: Top 250 tv shows, Max Results: 5

JSON
{
  "titles": [
    {
      "rank": 1,
      "year": 2008,
      "title": "Breaking Bad",
      "votes": 2682966,
      "runtime": "48 min",
      "title_id": "tt0903747",
      "imdb_link": "https://www.imdb.com/title/tt0903747/",
      "age_rating": "TV-MA",
      "imdb_rating": 9.5,
      "runtime_minutes": 48,
      "rank_change_since_last_week": null
    },
    {
      "rank": 2,
      "year": 2016,
      "title": "Planet Earth II",
      "votes": 177103,
      "runtime": "50 min",
      "title_id": "tt5491994",
      "imdb_link": "https://www.imdb.com/title/tt5491994/",
      "age_rating": "TV-G",
      "imdb_rating": 9.4,
      "runtime_minutes": 50,
      "rank_change_since_last_week": null
    },
    {
      "rank": 3,
      "year": 2006,
      "title": "Planet Earth",
      "votes": 237027,
      "runtime": "50 min",
      "title_id": "tt0795176",
      "imdb_link": "https://www.imdb.com/title/tt0795176/",
      "age_rating": "TV-PG",
      "imdb_rating": 9.4,
      "runtime_minutes": 50,
      "rank_change_since_last_week": null
    }
  ]
}

For developers

Run this workflow from your own code. In Studio, turn on Developer mode and create an API key.

cURL
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@imdb",
  "visibility": "public",
  "operation": "get_episode_ratings",
  "version": 1,
  "input": {
    "season": 2,
    "series": "The Office"
  },
  "response": {
    "format": "json"
  }
}'

What you can do with it

  • Compare ratings and runtimes across chart titles
  • Research a film or show's cast, crew, and budget
  • Review a person's biography, awards, and filmography
  • Track episode ratings and air dates by season
  • Assess age certifications and Parents Guide categories

Questions

Is Fous affiliated with IMDb?

No. Fous is not affiliated with IMDb. This workflow reads the public imdb.com website and returns its data.

How much does it cost?

Each run costs 1 credit. With pay-as-you-go, a credit costs 1¢; monthly plans cost less per credit.

Do I need a IMDb account?

No. You only need a Fous account.

How current is the data?

Fous gets the data from imdb.com when you run it; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 30, 2026.

What is a movie or show's IMDb rating?

Get movie or show returns the IMDb user rating out of 10 for a title.

Which episodes have ratings in a series?

Get episode ratings lists episodes with ratings, votes, air dates, and plots; you can select a season.

What age certifications and content categories are listed?

Get parents guide returns age certifications and Parents Guide category summaries for a movie or show.

All Entertainment workflowsBrowse all workflows