TMDB+API.SH

TMDB API

Movies, TV series, episodes, people, trailers, reviews and streaming availability from The Movie Database as JSON.

The API.SH TMDB API returns The Movie Database's public pages as JSON. A movie comes with title, tagline, overview, user score and votes, certification, genres, runtime, director and writers, top-billed cast, budget, revenue, collection, the featured trailer and the headline where-to-watch offer; include adds recommendations and every watch provider for a region. TV series add creators, networks, seasons and episode counts, and the season route lists each episode with air date, runtime and rating. Other routes return full cast and crew, user reviews, recommendations, trailers and images, people with biography and every credit, collections, companies and networks with their titles, and where to watch in one country with stream, rent and buy offers and prices. Lists cover trending today or this week, What's popular, upcoming, top rated, airing today, and discover with genre, language, score and date filters.

  • 17 endpoints
  • from $1 / 1,000 calls
  • 1,000 free credits / month
  • failed calls free
TMDB movie
GET https://api.api.sh/tmdb/v1/movie
{"id": 27205,"url": "https://www.themoviedb.org/movie/27205","title": "Inception","year": 2010,"tagline": "Your mind is the scene of the crime.","overview": "Cobb, a skilled thief who commits corporate espionage by infiltrating the subconscious of his targets is offered a chance to regain his old …","user_score": 84,"vote_average": 8.373,"vote_count": 40640,"certification": "PG-13","release": "07/16/2010 (US)","genres": ["Action","Science Fiction","… 1 more"],"runtime": "2h 28m","poster": "https://image.tmdb.org/t/p/original/xlaY2zyzMfkhk0HSC5VUwzoZPU1.jpg","backdrop": "https://media.themoviedb.org/t/p/original/8ZTVqvKDQ8emSGUEMjsS4yHAwrp.jpg","featured_crew": [{"name": "Christopher Nolan","jobs": ["Director","Writer"],"url": "https://www.themoviedb.org/person/525-christopher-nolan","id": 525}],"top_cast": [{"name": "Leonardo DiCaprio","character": "Dom Cobb","url": "https://www.themoviedb.org/person/6193-leonardo-dicaprio","id": 6193,"image": "https://media.themoviedb.org/t/p/original/wo2hJpn04vbtmh0B9utCFdsQhxM.jpg"},{"name": "Joseph Gordon-Levitt","character": "Arthur","url": "https://www.themoviedb.org/person/24045-joseph-gordon-levitt","id": 24045,"image": "https://media.themoviedb.org/t/p/original/z2FA8js799xqtfiFjBTicFYdfk.jpg"},"… 7 more"],"keywords": ["spy","allegory","… 12 more"],"links": {"justwatch": "https://www.justwatch.com/us/movie/inception","homepage": "https://www.warnerbros.com/movies/inception"},"streaming": {"label": "Available to Rent or Buy","provider": "Plex","logo": "https://media.themoviedb.org/t/p/original/blAEhvx3XX8sV0fFVFk88FFjubs.png","watch_url": "https://www.themoviedb.org/movie/27205-inception/watch"},"featured_video": {"site": "YouTube","key": "Jvurpf91omw","name": "Official Trailer","url": "https://www.youtube.com/watch?v=Jvurpf91omw"},"media_counts": {"videos": 27,"backdrops": 105,"posters": 229},"featured_review": {"id": "668a1e6660627d6f1dd25d9e","author": "Rohit Kabdwal","date": "July 7, 2024","teaser": null,"url": "https://www.themoviedb.org/review/668a1e6660627d6f1dd25d9e"},"date_modified": "2026-10-23T00:20:13Z","original_title": null,"status": "Released","original_language": "English","budget": 160000000,"revenue": 839030630,"countries": ["United States","United Kingdom"],"release_date": "2010-07-15","collection_id": null,"facts": {"Status": "Released","Original Language": "English","Budget": "$160,000,000","Revenue": "$839,030,630"},"cached": false,"credits_used": 1}
1 credit · $1 per 1,000 calls

What you can build with the TMDB API

Streaming availability checks

Call /tmdb/v1/watch-providers with a movie or series id and region=US to list every stream, rent, buy and free offer with provider, quality, price and link, and show users where to watch.

Release calendars

Read /tmdb/v1/upcoming with list=upcoming for films and the TV lists for what airs today, then open a series' current season to get each episode's air date and runtime.

Filtered catalogs for recommendation apps

Get genre ids from /tmdb/v1/genres and browse /tmdb/v1/discover with with_genres, vote_count.gte, a release_date range and sort_by, then add each title's recommendations.

Cast, crew and studio data

Pull the full cast and crew of a film with characters, jobs and departments, every credit of a person, and the movies or series of a production company or network.

Trend tracking for content teams

Store /tmdb/v1/trending with window=week and the What's popular lists such as category=streaming every day to see which titles rise before you plan coverage.

Media libraries and fan sites

Match files to titles with /tmdb/v1/search and year, then add trailers and posters from /tmdb/v1/movie/videos, full user reviews with full=1, and franchise order from /tmdb/v1/collection.

TMDB data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

TMDB collection/tmdb/v1/collection
id10urlhttps://www.themoviedb.org/colle…nameStar Wars CollectionoverviewAn epic space-opera theatrical f…user_score73number_of_movies9revenue8909187322posterhttps://media.themoviedb.org/t/p…backdrophttps://media.themoviedb.org/t/p…count9
featured_cast[]id · name · role · url · image
featured_crew[]id · name · role · url · image
movies[]id · type · title · original_title · release_date · overview · adult · url · poster
TMDB company or network/tmdb/v1/company
id1kindcompanyurlhttps://www.themoviedb.org/compa…nameLucasfilm Ltd.headquartersSan Francisco, CaliforniacountryUShomepagehttps://www.lucasfilm.comlogohttps://media.themoviedb.org/t/p…typemovietotal142page1count20next_page2
items[]id · type · title · original_title · release_date · overview · adult · url · poster
TMDB discover/tmdb/v1/discover
categorydiscovertypemoviepage1next_page2count20
filters[]sort_by · with_genres
items[]position · id · type · title · release_date · adult · url · poster

TMDB API endpoints and prices

Every TMDB endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery4
TMDB discover
/tmdb/v1/discover
params none required +11 optionaldocstry
$1 · $2 PAYG
1 credit
TMDB popular
/tmdb/v1/popular
params none required +12 optionaldocstry
$1 · $2 PAYG
1 credit
TMDB search
/tmdb/v1/search
params q +4 optionaldocstry
$1 · $2 PAYG
1 credit
TMDB trending
/tmdb/v1/trending
params none required +3 optionaldocstry
$1 · $2 PAYG
1 credit
Profiles and accounts2
TMDB company or network
/tmdb/v1/company
params none required +6 optionaldocstry
$1 · $2 PAYG
1 credit
TMDB person
/tmdb/v1/person
params none required +3 optionaldocstry
$1 · $2 PAYG
1 credit
Posts and media2
TMDB videos and images
/tmdb/v1/movie/videos
params id +5 optionaldocstry
$1 · $2 PAYG
1 credit
TMDB TV season and episodes
/tmdb/v1/tv/season
params none required +4 optionaldocstry
$1 · $2 PAYG
1 credit
Comments and reviews1
TMDB reviews
/tmdb/v1/movie/reviews
params id +3 optionaldocstry
$1 · $2 PAYG
1 credit
More data8
TMDB collection
/tmdb/v1/collection
params id +2 optionaldocstry
$1 · $2 PAYG
1 credit
TMDB genres
/tmdb/v1/genres
params none required +2 optionaldocstry
$1 · $2 PAYG
1 credit
TMDB movie
/tmdb/v1/movie
params none required +5 optionaldocstry
$1 · $2 PAYG
1 credit
TMDB movie cast and crew
/tmdb/v1/movie/credits
params none required +3 optionaldocstry
$1 · $2 PAYG
1 credit
TMDB recommendations
/tmdb/v1/movie/similar
params id +2 optionaldocstry
$1 · $2 PAYG
1 credit
TMDB TV series
/tmdb/v1/tv
params none required +5 optionaldocstry
$1 · $2 PAYG
1 credit
TMDB movie and TV lists
/tmdb/v1/upcoming
params none required +4 optionaldocstry
$1 · $2 PAYG
1 credit
TMDB where to watch
/tmdb/v1/watch-providers
params id +3 optionaldocstry
$1 · $2 PAYG
1 credit

Call the TMDB API

TMDB movie: GET https://api.api.sh/tmdb/v1/movie

curl "https://api.api.sh/tmdb/v1/movie?id=550" \
  -H "x-api-key: $APISH_KEY"
  1. Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
  2. Create an API keyOne key works for all 918 platforms.
  3. Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for TMDB data

  • Public data only: no TMDB login, cookies or account needed
  • One key and one response shape for TMDB and 917 other platforms
  • Built and maintained by API.SH, not third-party publishers
  • Pay per call; errors on our side cost nothing
  • No rate limits: run as many calls in parallel as you need
  • Live status for every endpoint

API.SH vs the official TMDB API

TMDB has an official API that is free for non-commercial use with an account, an API key and attribution; commercial use needs a license from TMDB. API.SH reads the public website instead, so there is no key application, and it returns what the site shows, such as each where-to-watch offer's price and quality.

Several TMDB scrapers on Apify and the Kodi add-ons ask for your own TMDB key, so you still go through its sign-up. API.SH needs only your API.SH key and returns IMDb, Letterboxd and Rotten Tomatoes data in the same format.

TMDB API questions

What TMDB data can I get?+

Titles: movie, TV series and season with episodes. Details: cast and crew, reviews, recommendations, videos and images, where to watch. People, collections, companies and networks. Lists: search, discover, genres, trending, popular and the upcoming, now playing, top rated and airing lists.

How much does the TMDB API cost?+

Every TMDB endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free tier?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /tmdb/v1/collection at 1 credit each.

Is there an official TMDB API?+

Yes. TMDB offers its own API with a free key for non-commercial projects that credit TMDB, and licenses for commercial use. Read its terms if you build a product on TMDB data, whichever way you fetch it.

Do I need a TMDB account or API key?+

No. You call API.SH with your API.SH key, and only public pages are read; lists, ratings and watchlists tied to a TMDB login are not.

How do I find where a movie is streaming?+

Call /tmdb/v1/watch-providers with id (for example 550) and region. Each offer has its type (stream, rent, buy, free, ads), provider, quality, price, best-price flag and link, and providers are also grouped by type.

How do I get every episode of a TV season?+

Use /tmdb/v1/tv/season with the series id and season number. It returns each episode's number, name, air date, runtime in minutes, overview, user rating and still image. /tmdb/v1/tv with include=seasons lists all seasons first.

Can I filter movies by genre, rating and year?+

Yes. /tmdb/v1/discover takes with_genres (ids from /tmdb/v1/genres), with_original_language, vote_average.gte and .lte, vote_count.gte and release_date.gte and .lte, with sort_by and 20 results a page.

How do I get started?+

Sign up at api.sh, copy your key and request /tmdb/v1/movie?id=550 for Fight Club. The docs at https://api.sh/docs show each TMDB filter and include option. Film newsletters and watchlist apps use it from Google Sheets, Zapier, Make and n8n, alongside the JS and Python SDKs and the MCP server at https://api.sh/mcp.

Does the TMDB API have a rate limit?+

No. API.SH puts no rate limit on your key: send as many TMDB calls in parallel as you need and pay only for the calls that run. If TMDB itself slows down, the call returns 503 with a retry-after header and is not charged.

More media & music APIs all music, movie & game APIs →

Start with 1,000 free credits
Every month, on every account. One key works for all 918 platforms.
Get a free API key