Movie details, TV show details and trending titles
TMDB returns movie and TV details, cast, trailers, releases, viewing services, scheduled upcoming movies, and up to 20 homepage trending titles; future episode details depend on published schedules.
Your information
Release year to distinguish similarly named movies, for example 2024.
Movie name or TMDB movie link, for example Dune: Part Two.
Country name or two-letter code for releases, ratings and watching options, for example France or FR.
Example results

King Kong
Beauty conquered the beast!
1,671 votes
Adventurous filmmaker Carl Denham sets out to produce a motion picture unlike anything the world has seen before. Alongside his leading lady Ann Darrow and his first mate Jack Driscoll, they arrive on an island and discover a legendary creature said to be neither beast nor man. Denham captures the monster to be displayed on Broadway as King Kong, the eighth wonder of the world.

About the film
- Original title
- King Kong
- Original language
- English
- Directors
- Ernest B. Schoedsack, Merian C. Cooper
- Writers
- James Ashmore Creelman, Ruth Rose
Genres
Adventure
Fantasy
Horror
Cast
Robert Armstrong
Carl Denham
Fay Wray
Ann Darrow
Bruce Cabot
Jack Driscoll
Frank Reicher
Captain Englehorn
Victor Wong
Ship's Cook Charlie
James Flavin
Mate Briggs
Sam Hardy
Charles Weston
Noble Johnson
Skull Island Native Chief
Steve Clemente
Skull Island Witch Doctor
Roscoe Ates
Press Photographer (uncredited)
Merian C. Cooper
Pilot of Plane that Kills Kong (uncredited)
Frances Curry
Intended Sacrificial Bride for Kong (Uncredited)
Paul Porcasi
Apple Vendor (uncredited)
Ernest B. Schoedsack
Machine-Gunner on Plane that Kills Kong (uncredited)
Harry Strang
Policeman at Headquarters (uncredited)
Trailers
Where to watch
Amazon Prime Video
Amazon Prime Video with Ads
BBC iPlayer
Apple TV Store
Amazon Video
Google Play Movies
YouTube
About the TMDB tool
TMDB's Get movie returns movie details, cast, trailers, releases, and viewing services from a title or link, with optional year and country.
Get tv show returns show details, cast, seasons, episodes, and viewing services from a show name or link, with optional country.
List trending returns homepage movie and TV titles by period; List upcoming movies returns country-specific theatrical releases for three weeks.
Built from themoviedb.org. Last checked Sep 29, 2026.
Actions
Get movie
1 creditFind a movie by title or TMDB link and return its details, cast, trailers, and country-specific releases and viewing services. IMDb IDs are not shown on public movie pages.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Yearyear | Number | Optional | Release year to distinguish similarly named movies, for example 2024.Example: 1933 |
Titletitle | Text | Required | Movie name or TMDB movie link, for example Dune: Part Two.Example: King Kong |
Countrycountry | Text | Optional | Country name or two-letter code for releases, ratings and watching options, for example France or FR.Example: GB |
What you get
| Field | Type | Description |
|---|---|---|
Castcast | List | |
Actorcast[].actor | Text | Example: Robert Armstrong |
Charactercast[].character | Text | Example: Carl Denham |
Titletitle | Text | Example: King Kong |
Budgetbudget | Details | |
Amountbudget.amount | Number | Example: 672000 |
Currencybudget.currency | Text | Example: USD |
Genresgenres | List | |
Revenuerevenue | Details | |
Amountrevenue.amount | Number | Example: 10001781 |
Currencyrevenue.currency | Text | Example: USD |
Runtimeruntime | Text | Example: 1h 40m |
Taglinetagline | Text | Example: Beauty conquered the beast! |
Tmdb IDtmdb_id | Number | Example: 244 |
Writerswriters | List | |
Overviewoverview | Text | Example: Adventurous filmmaker Carl Denham sets out to produce a motion picture unlike… |
Trailerstrailers | List | |
Linktrailers[].link | Text | Example: https://www.youtube.com/watch?v=H0WpKl2A_2k |
Titletrailers[].title | Text | Example: King Kong Trailer (1933) |
Directorsdirectors | List | |
Tmdb Linktmdb_link | Text | Example: https://www.themoviedb.org/movie/244-king-kong |
Age Ratingage_rating | Text | Example: PG |
Release Daterelease_date | Date | Example: 1933-06-23 |
Original Titleoriginal_title | Text | Example: King Kong |
Where to Watchwhere_to_watch | List | |
Number of Votesnumber_of_votes | Number | Example: 1671 |
Original Languageoriginal_language | Text | Example: English |
Poster Image Linkposter_image_link | Text | Example: https://media.themoviedb.org/t/p/original/lHlnxKL5GbgRibyRFI7n1Ey850i.jpg |
User Score (%)user_score_percent | Number | Example: 76 |
Backdrop Image Linkbackdrop_image_link | Text | Example: https://media.themoviedb.org/t/p/original/lYfHa1AtkUMtplrKx7SRLHpwonW.jpg |
Example result
For Year: 1933, Title: King Kong, Country: GB
{
"cast": [
{
"actor": "Robert Armstrong",
"character": "Carl Denham"
},
{
"actor": "Fay Wray",
"character": "Ann Darrow"
},
{
"actor": "Bruce Cabot",
"character": "Jack Driscoll"
}
],
"title": "King Kong",
"budget": {
"amount": 672000,
"currency": "USD"
},
"genres": [
"Adventure",
"Fantasy",
"Horror"
],
"revenue": {
"amount": 10001781,
"currency": "USD"
},
"runtime": "1h 40m",
"tagline": "Beauty conquered the beast!",
"tmdb_id": 244,
"writers": [
"James Ashmore Creelman",
"Ruth Rose"
],
"overview": "Adventurous filmmaker Carl Denham sets out to produce a motion picture unlike anything the world has seen before. Alongside his leading lady Ann Darrow and his first mate Jack Driscoll, they arrive on…",
"trailers": [
{
"link": "https://www.youtube.com/watch?v=H0WpKl2A_2k",
"title": "King Kong Trailer (1933)"
},
{
"link": "https://www.youtube.com/watch?v=I8P7RzqOU_M",
"title": "Trailer"
}
],
"directors": [
"Ernest B. Schoedsack",
"Merian C. Cooper"
],
"tmdb_link": "https://www.themoviedb.org/movie/244-king-kong",
"age_rating": "PG",
"release_date": "1933-06-23",
"original_title": "King Kong",
"where_to_watch": [
"Amazon Prime Video",
"Amazon Prime Video with Ads",
"BBC iPlayer"
],
"number_of_votes": 1671,
"original_language": "English",
"poster_image_link": "https://media.themoviedb.org/t/p/original/lHlnxKL5GbgRibyRFI7n1Ey850i.jpg",
"user_score_percent": 76,
"backdrop_image_link": "https://media.themoviedb.org/t/p/original/lYfHa1AtkUMtplrKx7SRLHpwonW.jpg"
}Get tv show
1 creditGet a TV show’s details, cast, seasons, episodes, and country-specific viewing services by name or TMDB link. Future and unaired episode details depend on the show’s published schedule.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Showshow | Text | Required | Show name or TMDB show link, for example The Bear or https://www.themoviedb.org/tv/136315-the-bear.Example: The Bear |
Countrycountry | Text | Optional | Country name or two-letter code for viewing services, for example Canada or CA. Defaults to United States.Example: Canada |
What you get
| Field | Type | Description |
|---|---|---|
Castcast | List | Up to 15 top-billed cast members. |
Namecast[].name | Text | Actor name.Example: Jeremy Allen White |
Charactercast[].character | Text | Character name.Example: Carmen 'Carmy' Berzatto |
Namename | Text | Show name.Example: The Bear |
Genresgenres | List | Genres. |
Statusstatus | Text | Returning series, ended, or canceled.Example: Ended |
Seasonsseasons | List | Seasons, including specials when listed. |
Nameseasons[].name | Text | Season name.Example: Season 1 |
Numberseasons[].number | Number | Season number.Example: 1 |
Air Dateseasons[].air_date | Text | Premiere date, YYYY-MM-DD, if listed.Example: 2022-06-23 |
Episode Countseasons[].episode_count | Number | Episode count.Example: 8 |
Tmdb IDtmdb_id | Number | TMDB show ID.Example: 136315 |
Creatorscreators | List | Show creators. |
Networksnetworks | List | Broadcast networks. |
Overviewoverview | Text | Show summary.Example: Carmy, a young fine-dining chef, comes home to Chicago to run his family… |
Tmdb Linktmdb_link | Text | Show page link on TMDB.Example: https://www.themoviedb.org/tv/136315-the-bear |
Poster Linkposter_link | Text | Show poster image link.Example: https://image.tmdb.org/t/p/w500/eKfVzzEazSIjJMrw9ADa2x8ksLz.jpg |
Next Episodenext_episode | Value | Next scheduled episode, if listed. |
Last Air Datelast_air_date | Text | Last recorded air date, YYYY-MM-DD.Example: 2026-06-25 |
First Air Datefirst_air_date | Text | Date the series first aired, YYYY-MM-DD.Example: 2022-06-23 |
Where to Watchwhere_to_watch | List | Services listed for the chosen country. |
Number of Seasonsnumber_of_seasons | Number | Number of regular seasons.Example: 5 |
Last Episode Airedlast_episode_aired | Value | Most recently aired episode, if listed. |
Number of Episodesnumber_of_episodes | Number | Number of episodes.Example: 46 |
User Score (%)user_score_percent | Number | TMDB user score as a percentage.Example: 82 |
Example result
For Show: The Bear
{
"cast": [
{
"name": "Jeremy Allen White",
"character": "Carmen 'Carmy' Berzatto"
},
{
"name": "Ebon Moss-Bachrach",
"character": "Richard 'Richie' Jerimovich"
},
{
"name": "Ayo Edebiri",
"character": "Sydney Adamu"
}
],
"name": "The Bear",
"genres": [
"Drama",
"Comedy"
],
"status": "ended",
"seasons": [
{
"name": "Season 1",
"number": 1,
"air_date": "2022-06-23",
"episode_count": 8
},
{
"name": "Season 2",
"number": 2,
"air_date": "2023-06-22",
"episode_count": 10
},
{
"name": "Season 3",
"number": 3,
"air_date": "2024-06-26",
"episode_count": 10
}
],
"tmdb_id": 136315,
"creators": [
"Christopher Storer"
],
"networks": [
"Hulu"
],
"overview": "Carmy, a young fine-dining chef, comes home to Chicago to run his family sandwich shop. As he fights to transform the shop and himself, he works alongside a rough-around-the-edges crew that ultimately…",
"tmdb_link": "https://www.themoviedb.org/tv/136315-the-bear",
"poster_link": "https://image.tmdb.org/t/p/w500/eKfVzzEazSIjJMrw9ADa2x8ksLz.jpg",
"next_episode": null,
"last_air_date": "2026-06-25",
"first_air_date": "2022-06-23",
"where_to_watch": [
"Hulu",
"Disney Plus",
"YouTube TV"
],
"number_of_seasons": 5,
"last_episode_aired": {
"title": "The Original Beef of Chicagoland",
"season": 5,
"air_date": "2026-06-25",
"episode_number": 8
},
"number_of_episodes": 46,
"user_score_percent": 82
}List trending
1 creditList TMDB homepage trending titles for today or this week, in displayed order, with scores and overviews. The homepage publishes up to 20 mixed movie and TV titles per period; movie and TV filters select from those 20, and trending people or later ranks are not available there.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Whatwhat | Text | Optional | Which trending titles to include, for example movies. People are not listed on the public trending homepage.Example: All |
Periodperiod | Text | Optional | Time period to display, for example this_week.Example: Today |
Max Resultsmax_results | Number | Optional | Maximum number of entries to return, for example 10. The public homepage lists only 20 mixed titles per period.Example: 5 |
What you get
| Field | Type | Description |
|---|---|---|
Trendingtrending | List | Titles in the homepage trending order. |
Ranktrending[].rank | Number | Position on the homepage trending list.Example: 1 |
Typetrending[].type | Text | Type of title.Example: Movie |
Yeartrending[].year | Number | Release or premiere year, if available.Example: 2026 |
Titletrending[].title | Text | Movie or show title.Example: Runner |
Overviewtrending[].overview | Text | Summary from the title page.Example: A former soldier is thrown into a brutal race against time when a critical… |
Tmdb Linktrending[].tmdb_link | Text | Title page link.Example: https://www.themoviedb.org/movie/1377237-runner |
User Scoretrending[].user_score | Number | TMDB user score as a percentage.Example: 77 |
Poster Linktrending[].poster_link | Text | Poster image link.Example: https://media.themoviedb.org/t/p/w220_and_h330_face/yBKMAIj7clP42UkFejhGDBBoTpb… |
Example result
For What: All, Period: Today, Max Results: 5
{
"trending": [
{
"rank": 1,
"type": "movie",
"year": 2026,
"title": "Runner",
"overview": "A former soldier is thrown into a brutal race against time when a critical medical delivery makes him and his unlikely partner the targets of a ruthless cartel. As the mission spirals into a deadly ma…",
"tmdb_link": "https://www.themoviedb.org/movie/1377237-runner",
"user_score": 77,
"poster_link": "https://media.themoviedb.org/t/p/w220_and_h330_face/yBKMAIj7clP42UkFejhGDBBoTpb.jpg"
},
{
"rank": 2,
"type": "TV show",
"year": 2026,
"title": "Lanterns",
"overview": "Two intergalactic cops, new recruit John Stewart and Lantern legend Hal Jordan, are drawn into a dark, Earth-based mystery as they investigate a murder in the American heartland.",
"tmdb_link": "https://www.themoviedb.org/tv/95350-lanterns",
"user_score": 83,
"poster_link": "https://media.themoviedb.org/t/p/w220_and_h330_face/gpC7h43xPMEV3goYMQShfJbTtLq.jpg"
},
{
"rank": 3,
"type": "movie",
"year": 2026,
"title": "Digger",
"overview": "The most powerful man in the world embarks on a frantic mission to prove he is humanity's savior before the disaster he's unleashed destroys everything.",
"tmdb_link": "https://www.themoviedb.org/movie/1248832-digger",
"user_score": 81,
"poster_link": "https://media.themoviedb.org/t/p/w220_and_h330_face/1ATXKrIPJyKNwnJ6lcG088Sa6zi.jpg"
}
]
}List upcoming movies
1 creditList movies scheduled for theatrical release in a country over the coming three weeks, soonest first. Dates are confirmed from the country-specific release calendar; details may be missing for unpublished titles.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Countrycountry | Text | Optional | Country name or two-letter country code, such as United States or US.Example: United Kingdom |
Max Resultsmax_results | Number | Optional | Maximum movies to return, such as 20 (up to 100).Example: 4 |
What you get
| Field | Type | Description |
|---|---|---|
Moviesmovies | List | Upcoming theatrical movies sorted by release date in the selected country. |
Titlemovies[].title | Text | Example: LINKIN PARK: UNSHATTER |
Genresmovies[].genres | List | |
Overviewmovies[].overview | Text | Example: In 1986 Madras, a timid eight-year-old boy accidentally traps a feared… |
Tmdb Linkmovies[].tmdb_link | Text | Example: https://www.themoviedb.org/movie/1388805-linkin-park-unshatter |
Poster Linkmovies[].poster_link | Text | Example: https://media.themoviedb.org/t/p/w116_and_h174_face/kHNrz7DBVPrtyMhJxmBm2poS2l9… |
Release Datemovies[].release_date | Date | Example: 2026-09-30 |
User Score (%)movies[].user_score_percent | Number | Example: 78 |
Example result
For Country: United Kingdom, Max Results: 4
{
"movies": [
{
"title": "LINKIN PARK: UNSHATTER",
"genres": [
"Music",
"Documentary"
],
"overview": "After a seven-year hiatus following the devastating loss of their beloved bandmate Chester Bennington, LINKIN PARK'S remaining members struggled to find their way forward. Their shared history and end…",
"tmdb_link": "https://www.themoviedb.org/movie/1388805-linkin-park-unshatter",
"poster_link": "https://media.themoviedb.org/t/p/w116_and_h174_face/kHNrz7DBVPrtyMhJxmBm2poS2l9.jpg",
"release_date": "2026-09-30",
"user_score_percent": null
},
{
"title": "Baththa",
"genres": [
"Thriller",
"Drama"
],
"overview": "In 1986 Madras, a timid eight-year-old boy accidentally traps a feared gangster inside a deserted school toilet. As the gangster is forced to confront hunger, loneliness and his own vulnerability, an …",
"tmdb_link": "https://www.themoviedb.org/movie/1515692",
"poster_link": "https://media.themoviedb.org/t/p/w116_and_h174_face/bsFSlIwsH0Lrqo9TtGv4KwvgKS1.jpg",
"release_date": "2026-10-01",
"user_score_percent": null
},
{
"title": "Nightmares",
"genres": [
"Drama",
"Thriller"
],
"overview": "The true story that became the basis one of the greatest horror movies of all time, following a journalist attempting to uncover the truth behind several unexplained deaths",
"tmdb_link": "https://www.themoviedb.org/movie/1505441-nightmares",
"poster_link": "https://media.themoviedb.org/t/p/w116_and_h174_face/iBGo3tzQ2fesULpZWlUYgOWASac.jpg",
"release_date": "2026-10-01",
"user_score_percent": null
}
]
}For developers
Call it from your code with one request. Change the values in input to run it on new data. To get an API key, open Developers at the bottom of Studio, turn on Developer mode and go to API keys.
curl 'https://api.fous.com/v1/query' \
--fail-with-body --silent --show-error --max-time 180 \
-H "Authorization: Bearer YOUR_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"api": "@tmdb",
"visibility": "public",
"operation": "get_movie",
"version": 1,
"input": {
"year": 1933,
"title": "King Kong",
"country": "GB"
},
"response": {
"format": "json"
}
}'What you can do with it
- Compare movie casts, genres, runtimes, and user scores.
- Find where movies and TV shows are available by country.
- Track TV show seasons, episodes, and air dates.
- Monitor trending movie and TV titles by period.
- Plan around upcoming theatrical releases in a country.
Questions about TMDB
Can I run it with my own inputs?
Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.
Can I call this TMDB tool as an API?
Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.
How much does it cost?
Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.
Do I need a TMDB account?
No. You only need a Fous account.
How current is the data?
Fous gets the data from themoviedb.org when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.
Who is in a movie's cast?
Get movie returns cast members and their characters.
What is the next scheduled episode?
Get tv show returns the next scheduled episode, if listed.
Which movies are coming to theaters in a country?
List upcoming movies returns scheduled theatrical releases for the selected country over the coming three weeks.