+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
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} 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 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
| TMDB discover /tmdb/ | $1 · $2 PAYG 1 credit |
| TMDB popular /tmdb/ | $1 · $2 PAYG 1 credit |
| TMDB search /tmdb/ | $1 · $2 PAYG 1 credit |
| TMDB trending /tmdb/ | $1 · $2 PAYG 1 credit |
| TMDB company or network /tmdb/ | $1 · $2 PAYG 1 credit |
| TMDB person /tmdb/ | $1 · $2 PAYG 1 credit |
| TMDB videos and images /tmdb/ | $1 · $2 PAYG 1 credit |
| TMDB TV season and episodes /tmdb/ | $1 · $2 PAYG 1 credit |
| TMDB reviews /tmdb/ | $1 · $2 PAYG 1 credit |
| TMDB collection /tmdb/ | $1 · $2 PAYG 1 credit |
| TMDB genres /tmdb/ | $1 · $2 PAYG 1 credit |
| TMDB movie /tmdb/ | $1 · $2 PAYG 1 credit |
| TMDB movie cast and crew /tmdb/ | $1 · $2 PAYG 1 credit |
| TMDB recommendations /tmdb/ | $1 · $2 PAYG 1 credit |
| TMDB TV series /tmdb/ | $1 · $2 PAYG 1 credit |
| TMDB movie and TV lists /tmdb/ | $1 · $2 PAYG 1 credit |
| TMDB where to watch /tmdb/ | $1 · $2 PAYG 1 credit |
Call the TMDB API
TMDB movie: GET https://api.api.sh/tmdb/
curl "https://api.api.sh/tmdb/v1/movie?id=550" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/tmdb/v1/movie",
params={"id": "550"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/tmdb/v1/movie");
url.searchParams.set("id", "550");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); # Google Sheets (API.SH add-on)
=APISH("/tmdb/v1/movie", "id", "550")
# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "TMDB" and "TMDB movie".
# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp - Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
- Create an API keyOne key works for all 918 platforms.
- Send the requestJSON back in one call. Add
output=csvoroutput=ndjsonfor 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.