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.
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.
Example results
- Imdb Link
- imdb.com
- Year Range
- 2008–2013
- Series Title
- Breaking Bad
- Number of Seasons
- 5
- Episodes
Episodes Episode Title Air Date Episode ID Short Plot Imdb Rating Episode Link Season Number Episode Number Number of Votes Live Free or Die2012-07-15tt2081647After 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.25166,283Madrigal2012-07-22tt2301457As 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.85258,669Hazard Pay2012-07-29tt2301459Walt, 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.85358,155Fifty-One2012-08-05tt2301461As 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.85458,487Dead Freight2012-08-12tt2301463Walt, 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.65588,415Buyout2012-08-19tt2301465A 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.95660,911Say My Name2012-08-26tt2301467As 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.65784,361Gliding Over All2012-09-02tt2301469As 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.55874,767Blood Money2013-08-11tt2301471As 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.45970,477Buried2013-08-18tt2301443As Hank presses Skyler for answers, Walt scrambles to safeguard his family and fortune, while Jesse's increasingly erratic behavior draws unwanted attention.9.251064,851Confessions2013-08-25tt2301445As 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.651182,422Rabid Dog2013-09-01tt2301447As 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.151269,735To'hajiilee2013-09-08tt2301449As 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.7513130,431Ozymandias2013-09-15tt2301451In 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.5514508,902Granite State2013-09-22tt2301453As 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.6515125,553Felina2013-09-29tt2301455Walt returns to Albuquerque to settle unfinished business, secure his family's future, and confront the consequences of the empire he built.9.8516297,625
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 runList 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
| Field | Type | Required | Description |
|---|---|---|---|
Seasonseason | Number | Optional | Season number, for example 2. Default 0 means all seasons.Example: 2 |
Seriesseries | Text | Required | TV series name, IMDb title link, or title ID, for example Breaking Bad.Example: The Office |
What you get
| Field | Type | Description |
|---|---|---|
Episodesepisodes | List | |
Air Dateepisodes[].air_date | Date | Example: 2012-07-15 |
Episode IDepisodes[].episode_id | Text | Example: tt2081647 |
Short Plotepisodes[].short_plot | Text | Example: After a deadly showdown, Walt and Jesse race to destroy evidence that could… |
Imdb Ratingepisodes[].imdb_rating | Number | IMDb rating out of 10; null if unrated or unaired.Example: 9.2 |
Episode Linkepisodes[].episode_link | Text | Example: https://www.imdb.com/title/tt2081647/ |
Episode Titleepisodes[].episode_title | Text | Example: Live Free or Die |
Season Numberepisodes[].season_number | Number | Season number, if known.Example: 5 |
Episode Numberepisodes[].episode_number | Number | Episode number within the season, if known.Example: 1 |
Number of Votesepisodes[].number_of_votes | Number | Example: 66283 |
Imdb Linkimdb_link | Text | Example: https://www.imdb.com/title/tt0903747/ |
Year Rangeyear_range | Text | Example: 2008–2013 |
Series Titleseries_title | Text | Example: Breaking Bad |
Number of Seasonsnumber_of_seasons | Number | Example: 5 |
Example result
For Season: 5, Series: https://www.imdb.com/title/tt0903747/
{
"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 runGet 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
| Field | Type | Required | Description |
|---|---|---|---|
Yearyear | Number | Optional | Release or first aired year to distinguish matching names, e.g. 2023.Example: 2023 |
Titletitle | Text | Required | Movie or show name, IMDb title link, or title ID, e.g. Oppenheimer or tt15398776.Example: Breaking Bad |
What you get
| Field | Type | Description |
|---|---|---|
Castcast | List | |
Actorcast[].actor | Text | Example: Bryan Cranston |
Charactercast[].character | Text | Example: Walter White |
Typetype | Text | Example: TV series |
Yearyear | Number | Example: 2008 |
Titletitle | Text | Example: Breaking Bad |
Budgetbudget | Details | |
Amountbudget.amount | Number | Example: 100000000 |
Currencybudget.currency | Text | Example: USD |
Genresgenres | List | |
Runtimeruntime | Text | Example: 48 min |
Writerswriters | List | |
Countriescountries | List | |
Directorsdirectors | List | |
Imdb Linkimdb_link | Text | Example: https://www.imdb.com/title/tt0903747/ |
Languageslanguages | List | |
Metascoremetascore | Number | Example: 90 |
Age Ratingage_rating | Text | Example: TV-MA |
Vote Countvote_count | Number | Example: 2682966 |
Imdb Ratingimdb_rating | Number | IMDb user rating out of 10.Example: 9.5 |
Years Airedyears_aired | Text | Example: 2008–2013 |
Plot Summaryplot_summary | Text | Example: A chemistry teacher diagnosed with inoperable lung cancer turns to… |
Release Daterelease_date | Date | Example: 2008-01-20 |
Imdb Title IDimdb_title_id | Text | Example: tt0903747 |
Awards Summaryawards_summary | Text | Example: Won 16 Primetime Emmys. 172 wins and 269 nominations total. |
Runtime (minutes)runtime_minutes | Number | Example: 48 |
Worldwide Grossworldwide_gross | Details | |
Amountworldwide_gross.amount | Number | Example: 975811333 |
Currencyworldwide_gross.currency | Text | Example: USD |
Poster Image Linkposter_image_link | Text | Example: https://m.media-amazon.com/images/M/MV5BMzU5ZGYzNmQtMTdhYy00OGRiLTg0NmQtYjVjNzl… |
Example result
For Title: Breaking Bad
{
"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 runGet 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
| Field | Type | Required | Description |
|---|---|---|---|
Yearyear | Number | Optional | Release or first-air year to select a matching title, such as 2016.Example: 1995 |
Titletitle | Text | Required | Movie or show name, IMDb title link, or title ID, such as Deadpool or tt1431045.Example: Deadpool |
What you get
| Field | Type |
|---|---|
Yearyear | Number |
Titletitle | Text |
Imdb Linkimdb_link | Text |
Categoriescategories | List |
Categorycategories[].category | Text |
Severitycategories[].severity | Text |
Imdb Linkcategories[].imdb_link | Text |
Mild Votescategories[].mild_votes | Number |
None Votescategories[].none_votes | Number |
Severe Votescategories[].severe_votes | Number |
Moderate Votescategories[].moderate_votes | Number |
Example Descriptionscategories[].example_descriptions | List |
Age Certificationsage_certifications | List |
Notesage_certifications[].notes | Text |
Ratingage_certifications[].rating | Text |
Countryage_certifications[].country | Text |
Get person
1 credit per runFind 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
| Field | Type | Required | Description |
|---|---|---|---|
Namename | Text | Required | The person’s name, IMDb person link, or person ID, for example Cillian Murphy.Example: https://www.imdb.com/name/nm0634240/ |
Max Creditsmax_credits | Number | Optional | Maximum number of credits to return, for example 50.Example: 70 |
What you get
| Field | Type | Description |
|---|---|---|
Namename | Text | Example: Christopher Nolan |
Imdb Linkimdb_link | Text | Example: https://www.imdb.com/name/nm0634240/ |
Person IDperson_id | Text | Example: nm0634240 |
Birth Datebirth_date | Date | Example: 1970-07-30 |
Birthplacebirthplace | Text | Example: London, England, UK |
Death Datedeath_date | Date | |
Photo Linkphoto_link | Text | Example: https://m.media-amazon.com/images/M/MV5BNjE3NDQyOTYyMV5BMl5BanBnXkFtZTcwODcyODU… |
Filmographyfilmography | List | |
Typefilmography[].type | Text | Example: Movie |
Yearfilmography[].year | Number | Example: 2026 |
Titlefilmography[].title | Text | Example: The Odyssey |
Title IDfilmography[].title_id | Text | Example: tt33764258 |
Imdb Linkfilmography[].imdb_link | Text | Example: https://www.imdb.com/title/tt33764258/ |
Imdb Ratingfilmography[].imdb_rating | Number | Example: 8.4 |
Role or Jobfilmography[].role_or_job | Text | Example: produced by; written for the screen by; Director; writer: "When I'm Home" |
Awards Summaryawards_summary | Text | Example: 2 Oscar wins; 6 Oscar nominations; 235 total wins; 302 other nominations |
Short Biographyshort_biography | Text | Example: Best known for his cerebral, often nonlinear, storytelling, acclaimed Academy… |
Known for Titlesknown_for_titles | List | |
Main Professionsmain_professions | List |
Example result
For Name: https://www.imdb.com/name/nm0634240/, Max Credits: 70
{
"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 runList 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
| Field | Type | Required | Description |
|---|---|---|---|
Chartchart | Text | Optional | Chart to list, for example top_250_movies.Example: Top 250 tv shows |
Max Resultsmax_results | Number | Optional | Maximum number of titles, for example 50. Popular charts have at most 100 titles.Example: 5 |
What you get
| Field | Type | Description |
|---|---|---|
Titlestitles | List | Titles in chart order. |
Ranktitles[].rank | Number | Position in the chosen chart.Example: 1 |
Yeartitles[].year | Number | First release year, if available.Example: 2008 |
Titletitles[].title | Text | Movie or show title.Example: Breaking Bad |
Votestitles[].votes | Number | Number of IMDb rating votes, if available.Example: 2682966 |
Runtimetitles[].runtime | Text | Runtime, such as 2 h 22 min, if available.Example: 48 min |
Title IDtitles[].title_id | Text | IMDb title identifier.Example: tt0903747 |
Imdb Linktitles[].imdb_link | Text | IMDb page for this title.Example: https://www.imdb.com/title/tt0903747/ |
Age Ratingtitles[].age_rating | Text | Content rating, such as R or TV-MA, if available.Example: TV-MA |
Imdb Ratingtitles[].imdb_rating | Number | IMDb audience rating out of 10, if available.Example: 9.5 |
Runtime (minutes)titles[].runtime_minutes | Number | Runtime in minutes, if available.Example: 48 |
Rank Change Since Last Weektitles[].rank_change_since_last_week | Number | Weekly 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
{
"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.
# 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.