Skip to content

Database · Beta

The Movie Database (TMDB)
API integration

Ship Database features without building the integration. Full The Movie Database (TMDB) API access via Proxy and 150+ MCP-ready tools for AI agents — extend models and mappings to fit your product.

Built for specific customer use cases. Issues are resolved quickly.

Talk to us
The Movie Database (TMDB)

Use Cases

Why integrate with The Movie Database (TMDB)

Common scenarios for SaaS companies building The Movie Database (TMDB) integrations for their customers.

01

Launch white-label VOD platforms with instant metadata

Video CMS providers let their broadcaster customers enter a single TMDB ID and auto-populate titles, synopses, cast, season/episode hierarchy, and artwork. This eliminates hours of manual catalog entry per title and gets regional streaming services to market faster.

02

Power global streaming availability in consumer apps

Media discovery and recommendation platforms surface 'Watch Now on Netflix/Hulu/Amazon' buttons using TMDB's JustWatch-backed watch provider data, segmented by country. Offering this as a native integration removes the need for customers to contract with JustWatch directly.

03

Enable native TMDB accounts inside community and fan platforms

Forum and community software connects end users' personal TMDB accounts so they can rate titles, sync watchlists, and manage favorites without leaving the product. Truto handles the token-and-session auth flow so the SaaS ships bidirectional sync in days.

04

Feed AdTech and analytics tools with trending signals

Media planning and contextual advertising platforms ingest TMDB's proprietary popularity scores, trending endpoints, and keyword metadata to forecast cultural moments and build contextual ad segments. Customers get a live pulse on entertainment demand without maintaining their own scraping infrastructure.

05

Automate localized catalog compliance for regulated distribution

In-flight entertainment, kids' streaming, and regional distribution platforms pull certifications, release dates, and multi-language translations to enforce content ratings and localize UIs per market. TMDB becomes the compliance and localization layer, not a build-it-yourself system.

What You Can Build

Ship these features with Truto + The Movie Database (TMDB)

Concrete product features your team can ship faster by leveraging Truto’s The Movie Database (TMDB) integration instead of building from scratch.

01

One-click catalog enrichment from a TMDB ID

Let customers paste a TMDB ID or external ID and auto-hydrate movies, TV shows, seasons, episodes, credits, images, videos, and translations into their local catalog.

02

Universal media search bar

Ship a multi-entity search that queries movies, TV shows, and people in a single call and returns ranked, image-rich results for command palettes, chat commands, or admin pickers.

03

Region-aware 'Where to Watch' widgets

Render streaming, rental, and purchase options per country using watch provider endpoints tied to ISO 3166-1 region codes, updated automatically as availability changes.

04

Two-way watchlist, favorites, and ratings sync

Connect an end user's TMDB account and bidirectionally sync their watchlist, favorite movies and TV shows, and per-title ratings including per-episode ratings.

05

Delta-based catalog synchronization

Use movie, TV, and person changes endpoints to keep local mirrors fresh with incremental updates instead of full re-imports, minimizing API load and stale metadata.

06

Discovery-powered dynamic feeds

Build editorial rails like 'Top-Rated Sci-Fi 2023' or 'Trending This Week' using discover and trending endpoints with configurable filters for genre, release window, popularity, and provider.

SuperAI

The Movie Database (TMDB) AI agent tools

Comprehensive AI agent toolset with fine-grained control. Integrates with MCP clients like Cursor and Claude, or frameworks like LangChain.

list_all_the_movie_database_tmdb_3_authentications

Validate a themoviedb API key to confirm it is active and recognized. Returns: success, status_code, status_message. No caller-supplied parameters are required.

get_single_the_movie_database_tmdb_3_account_by_id

Get details of a TMDB account by id. Returns: avatar, id, iso_639_1, iso_3166_1, name, include_adult, username. Required: id.

create_a_the_movie_database_tmdb_favorite

Mark a movie or TV show as a favourite on a TMDB account. Returns: status_code, status_message. Required: account_id, RAW_BODY.

create_a_the_movie_database_tmdb_watchlist

Add a movie or TV show to a themoviedb account's watchlist. Returns: status_code, status_message. Required: account_id, RAW_BODY.

list_all_the_movie_database_tmdb_favorite_movies

List a user's favorite movies on The Movie Database. Returns each movie with id, title, overview, release_date, poster_path, backdrop_path, genre_ids, vote_average, vote_count, and popularity. Required: account_id.

list_all_the_movie_database_tmdb_favorite_tvs

List a user's favorite TV shows on themoviedb. Returns: adult, backdrop_path, genre_ids, id, origin_country, original_language, original_name, overview, popularity, poster_path, first_air_date, name, vote_average, vote_count. Required: account_id.

the_movie_database_tmdb_tv_episodes_account_states

Get the rating, watchlist, and favourite status for a specific TheMovieDB TV episode. Returns: id, favorite, rated, watchlist. Required: series_id, season_number, episode_number.

the_movie_database_tmdb_tv_episodes_changes

Get the recent changes for a TheMovieDB TV episode by episode id. Returns: changes. Required: episode_id.

the_movie_database_tmdb_tv_episodes_credits

Get the cast, crew, and guest stars for a specific TV episode in TMDB. Returns: cast, crew, guest_stars, id. Required: series_id, season_number, episode_number.

the_movie_database_tmdb_tv_episodes_external_ids

Get the external IDs for a specific TV episode in TMDB. Returns: id, imdb_id, freebase_mid, freebase_id, tvdb_id, tvrage_id, wikidata_id. Required: series_id, season_number, episode_number.

the_movie_database_tmdb_tv_episodes_images

Get the still images that belong to a specific TV episode in TMDB. Returns the episode id and an array of stills, each including aspect_ratio, height, width, file_path, iso_639_1, vote_average, and vote_count. Required: series_id, season_number, episode_number.

the_movie_database_tmdb_tv_episodes_translations

Get the translations that have been added to a specific TV episode in TMDB. Returns the episode id and an array of translations, each including iso_3166_1, iso_639_1, name, english_name, and a data object with the translated name and overview. Required: series_id, season_number, episode_number.

the_movie_database_tmdb_tv_episodes_videos

Get the videos that belong to a specific TV episode in TMDB. Returns: iso_639_1, iso_3166_1, name, key, site, size, type, official, published_at, id. Required: series_id, season_number, episode_number.

the_movie_database_tmdb_tv_episodes_add_rating

Rate a TV episode on TMDB and save it to your rated list. Returns: status_code, status_message. Required: series_id, season_number, episode_number, RAW_BODY.

the_movie_database_tmdb_tv_episodes_delete_rating

Delete your rating on a TV episode on TMDB. Returns: status_code, status_message. Required: series_id, season_number, episode_number.

list_all_the_movie_database_tmdb_watchlist_movies

List movies on a TheMovieDB account's watchlist. Returns each movie's id, title, original_title, overview, poster_path, backdrop_path, release_date, popularity, vote_average, and vote_count. Required: account_id.

list_all_the_movie_database_tmdb_watchlist_tvs

List TV shows added to a user's watchlist on TheMovieDB. Returns: adult, backdrop_path, genre_ids, id, origin_country, original_language, original_name, overview, popularity, poster_path, first_air_date, name, vote_average, vote_count. Results can be sorted by created_at ascending or descending. Required: account_id.

list_all_the_movie_database_tmdb_guest_session_news

Create a new guest session in The Movie Database (themoviedb). Returns: success, guest_session_id, expires_at. The guest session can be used to rate movies and TV shows without requiring a registered user account.

create_a_the_movie_database_tmdb_convert_4

Convert a themoviedb v4 access token into a v3 session id. Returns: success, session_id. Required: RAW_BODY.

create_a_the_movie_database_tmdb_token_validate_with_login

Validate a TheMovieDB request token with a user's username and password to create a session with login. Returns: success, expires_at, request_token. Required: RAW_BODY.

create_a_the_movie_database_tmdb_authentication_session

Create a TMDB session from a previously validated request token. Returns: success, session_id. Required: RAW_BODY.

the_movie_database_tmdb_authentication_sessions_bulk_delete

Delete a TMDB authentication session, invalidating the session_id so it can no longer be used. Returns: success. Required: RAW_BODY.

list_all_the_movie_database_tmdb_movie_changes

List movie IDs that have been changed in the past 24 hours on themoviedb. Each result contains only the movie id and its adult flag. Returns: id, adult. Filter the change window with optional start_date and end_date parameters.

list_all_the_movie_database_tmdb_person_changes

List recently changed people in themoviedb, optionally filtered by a date range. Returns: id, adult.

list_all_the_movie_database_tmdb_tv_changes

List TV series that have been recently changed in TheMovieDB, optionally filtered by a date range. Returns: id, adult. The endpoint returns only the TMDb IDs of changed TV series (use the TV details endpoint to fetch full metadata).

get_single_the_movie_database_tmdb_3_collection_by_id

Get themoviedb collection details by id. Returns: id, original_language, original_name, overview, poster_path, backdrop_path, parts. Required: id.

list_all_the_movie_database_tmdb_images

Get the images that belong to a collection in TheMovieDB. Returns: id, backdrops, posters. Required: collection_id.

list_all_the_movie_database_tmdb_translations

List translations for a collection in TheMovieDB. Returns: id, translations. Required: collection_id.

get_single_the_movie_database_tmdb_3_company_by_id

Get a single themoviedb company by id. Returns: description, headquarters, homepage, id, logo_path, name, origin_country, parent_company. Required: id.

list_all_the_movie_database_tmdb_alternative_names

List alternative names for a TheMovieDB company by company id. Returns the company id and a results array where each item contains the alternative name and its type. Required: company_id.

list_all_the_movie_database_tmdb_3_configurations

Get the themoviedb API configuration details. Returns the images object (containing base_url, secure_base_url, and available backdrop, logo, poster, profile, and still sizes) and the change_keys array listing all resource keys that support change tracking.

list_all_the_movie_database_tmdb_configuration_countries

List TMDB countries (ISO 3166-1 tags) used throughout TMDB. Returns: iso_3166_1, english_name, native_name, name, in, schema.

list_all_the_movie_database_tmdb_configuration_jobs

List the jobs and departments used on TMDB. Returns: department, jobs. No required parameters.

list_all_the_movie_database_tmdb_configuration_languages

List the languages (ISO 639-1 tags) used throughout TMDB. Returns: iso_639_1, english_name, name.

list_all_configuration_primary_translations

List the officially supported primary translations on TMDB. Returns an array of locale codes (e.g., en-US, fr-FR, de-DE, ja-JP, zh-CN) representing the translation locales available.

list_all_the_movie_database_tmdb_configuration_timezones

List all timezones used throughout The Movie Database (themoviedb), grouped by country code. Each entry maps an ISO 3166-1 country code to its timezone identifiers. Returns: iso_3166_1, zones.

get_single_the_movie_database_tmdb_3_credit_by_id

Get movie or TV credit details by ID in themoviedb. Returns: credit_type, department, job, media, media_type, id, person. Required: id.

list_all_the_movie_database_tmdb_discover_movies

Discover movies in TheMovieDB using over 30 filters and sort options. Returns: adult, backdrop_path, genre_ids, id, original_language, original_title, overview, popularity, poster_path, release_date, title, video, vote_average, vote_count. All parameters are optional.

list_all_the_movie_database_tmdb_discover_tvs

Discover TV shows in themoviedb using over 30 filters and sort options. Returns: backdrop_path, first_air_date, genre_ids, id, name, origin_country, original_language, original_name, overview, popularity, poster_path, vote_average, vote_count.

get_single_the_movie_database_tmdb_3_find_by_id

Find themoviedb data by external ID (e.g. an IMDb ID or TVDB ID). Returns: movie_results, person_results, tv_results, tv_episode_results, tv_season_results. Required: id, external_source.

get_single_the_movie_database_tmdb_3_keyword_by_id

Get a single keyword from TheMovieDB by id. Returns: id, name. Required: id.

list_all_the_movie_database_tmdb_movies

List movies associated with a specific keyword in themoviedb. Returns: id, page, results, total_pages, total_results. Required: keyword_id.

the_movie_database_tmdb_movies_images

Get the images (backdrops, logos, posters) that belong to a specific movie in themoviedb. Returns: backdrops, id, logos, posters. Required: movie_id.

the_movie_database_tmdb_movies_lists

List the themoviedb user-created lists that a specific movie has been added to. Returns: description, favorite_count, id, item_count, iso_639_1, list_type, name, poster_path. Required: movie_id.

the_movie_database_tmdb_movies_translations

Get the translations for a specific themoviedb movie. Returns a list of translations, each with country code, language code, native and English names, and translated data (homepage, overview, runtime, tagline, title). Required: movie_id.

list_all_the_movie_database_tmdb_add_items

Add a movie to a themoviedb list by providing its media_id. Returns: status_code, status_message. Required: list_id, session_id.

list_all_the_movie_database_tmdb_item_status

Check whether a specific movie has already been added to a themoviedb list. Returns: id, item_present. Required: list_id.

list_all_the_movie_database_tmdb_clears

Clear all items from a TheMovieDB list. Returns: status_code, status_message. Required: list_id, session_id, confirm.

create_a_the_movie_database_tmdb_3_list

Create a new custom list on TMDB by providing a name, description, and language. Returns: status_message, success, status_code, list_id. Required: session_id, RAW_BODY.

get_single_the_movie_database_tmdb_3_list_by_id

Get details of a specific TMDB list by id, including its creator, description, favorite count, and the media items it contains. Returns: created_by, description, favorite_count, id, items, item_count, iso_639_1, poster_path. Required: id.

delete_a_the_movie_database_tmdb_3_list_by_id

Delete a TMDB list by id. Returns: status_code, status_message. Required: id, session_id.

list_all_the_movie_database_tmdb_remove_items

Remove a movie from a TMDB list by providing its media_id. Returns: status_code, status_message. Required: list_id, session_id, RAW_BODY.

list_all_the_movie_database_tmdb_movie_now_playings

List movies currently playing in theatres on TheMovieDB. Returns: adult, backdrop_path, genre_ids, id, original_language, original_title, overview, popularity, poster_path, release_date, title, video, vote_average, vote_count. Optional language and region filters may be supplied.

list_all_the_movie_database_tmdb_movie_populars

List popular movies from themoviedb ordered by popularity. Returns each movie's id, title, overview, popularity, release_date, vote_average, vote_count, poster_path, backdrop_path, genre_ids, original_language, original_title, adult, and video fields. Optional: language, region.

list_all_the_movie_database_tmdb_movie_top_rateds

List top-rated movies from The Movie Database ordered by rating. Returns: adult, backdrop_path, genre_ids, id, original_language, original_title, overview, popularity, poster_path, release_date, title, video, vote_average, vote_count.

list_all_the_movie_database_tmdb_movie_upcomings

List upcoming movies from The Movie Database that are being released soon. Returns: adult, backdrop_path, genre_ids, id, original_language, original_title, overview, popularity, poster_path, release_date, title, video, vote_average, vote_count.

get_single_the_movie_database_tmdb_3_movie_by_id

Get the top-level details of a movie by ID in TheMovieDB. Returns: adult, backdrop_path, belongs_to_collection, budget, genres, homepage, id, imdb_id, origin_country, original_language, original_title, overview, popularity, poster_path, production_companies, production_countries, release_date, revenue, runtime, spoken_languages, status, tagline, title, video, vote_average, vote_count. Required: id.

list_all_the_movie_database_tmdb_account_states

Get the rating, watchlist, and favourite status of a movie in themoviedb. Returns: id, favorite, rated, watchlist. Required: movie_id.

list_all_the_movie_database_tmdb_alternative_titles

List alternative titles for a specific movie in themoviedb. Returns the movie id and an array of titles, each with iso_3166_1, title, and type. Required: movie_id.

list_all_the_movie_database_tmdb_changes

List recent changes for a movie in TheMovieDB. Returns a changes array where each group has a key and items with id, action, time, iso_639_1, iso_3166_1, and value. Required: movie_id.

list_all_the_movie_database_tmdb_credits

List cast and crew credits for a themoviedb movie by movie_id. Returns the movie id with cast and crew arrays; cast entries include character, credit_id, cast_id, and order, while crew entries include department, job, and credit_id. Required: movie_id.

list_all_the_movie_database_tmdb_external_ids

Get the external IDs for a specific movie in TheMovieDB. Returns: id, imdb_id, wikidata_id, facebook_id, instagram_id, twitter_id. Required: movie_id.

list_all_the_movie_database_tmdb_keywords

List keywords associated with a specific movie in TheMovieDB. Returns: id, keywords. Required: movie_id.

list_all_the_movie_database_tmdb_movie_latests

Get the newest movie added to themoviedb. Returns: adult, backdrop_path, belongs_to_collection, budget, genres, homepage, id, imdb_id, original_language, original_title, overview, popularity, poster_path, production_companies, production_countries, release_date, revenue, runtime, spoken_languages, status, tagline, title, video, vote_average, vote_count.

list_all_the_movie_database_tmdb_recommendations

List movie recommendations from themoviedb based on a specific movie. Returns: id. Required: movie_id.

list_all_the_movie_database_tmdb_release_dates

List release dates and certifications for a themoviedb movie, grouped by country. Returns: id, results. Required: movie_id.

list_all_the_movie_database_tmdb_reviews

List user reviews for a movie in TheMovieDB. Returns: id, page, results, total_pages, total_results, author, author_details, content, created_at, updated_at, url. Required: movie_id.

list_all_the_movie_database_tmdb_similars

List similar movies in TheMovieDB based on genres and keywords. Returns: page, results, total_pages, total_results. Required: movie_id.

list_all_the_movie_database_tmdb_videos

List videos for a specific movie in TheMovieDB. Returns each video with its id, name, key, site, type, size, official, published_at, iso_639_1, and iso_3166_1. Required: movie_id.

list_all_the_movie_database_tmdb_watch_providers

List streaming watch providers for a movie in themoviedb, grouped by country. Returns: id, results. Required: movie_id.

create_a_the_movie_database_tmdb_rating

Add a rating to a movie in themoviedb and save it to your rated list. Returns: status_code, status_message. Required: movie_id, RAW_BODY.

the_movie_database_tmdb_ratings_bulk_delete

Delete a user rating for a movie in themoviedb. Returns: status_code, status_message. Required: movie_id.

get_single_the_movie_database_tmdb_3_network_by_id

Get details about a specific TV network in TheMovieDB by id. Returns: headquarters, homepage, id, logo_path, name, origin_country. Required: id.

list_all_the_movie_database_tmdb_person_populars

List popular people from TheMovieDB ordered by popularity. Returns: adult, gender, id, known_for, known_for_department, name, popularity, profile_path.

get_single_the_movie_database_tmdb_3_person_by_id

Get top-level details for a specific person in The Movie Database by id. Returns: adult, also_known_as, biography, birthday, deathday, gender, homepage, id, imdb_id, known_for_department, place_of_birth, popularity, profile_path. Supports append_to_response to bundle up to 20 additional sub-endpoints in one request. Required: id.

list_all_the_movie_database_tmdb_combined_credits

Get the combined movie and TV credits for a person in TheMovieDB. Returns a cast array of credit items containing media metadata such as id, title, character, credit_id, order, media_type, overview, and vote details. Required: person_id.

list_all_the_movie_database_tmdb_person_latests

Get the most recently created person from themoviedb. This is a live response that continuously changes as new persons are added. Returns: adult, also_known_as, biography, birthday, deathday, gender, homepage, id, imdb_id, known_for_department, name, place_of_birth, popularity, profile_path.

list_all_the_movie_database_tmdb_movie_credits

Movie Credits. Returns: cast, crew, id. Required: person_id.

list_all_the_movie_database_tmdb_tv_credits

List TV show credits for a person in TheMovieDB. Returns: cast, crew, id. Required: person_id.

list_all_the_movie_database_tmdb_tagged_images

List tagged images for a person in themoviedb. Returns each tagged image with its id, file_path, image_type, aspect_ratio, width, height, vote_average, vote_count, iso_639_1, media, and media_type. Required: person_id.

get_single_the_movie_database_tmdb_3_review_by_id

Get a specific movie or TV show review from The Movie Database by id. Returns: id, author, author_details, content, created_at, iso_639_1, media_id, media_title, media_type, updated_at, url. Required: id.

list_all_the_movie_database_tmdb_search_collections

Search themoviedb collections by their original, translated, and alternative names. Returns: adult, backdrop_path, id, name, original_language, original_name, overview, poster_path, title, original_title, media_type, genre_ids, popularity, release_date, video, vote_average, vote_count. Required: query.

list_all_the_movie_database_tmdb_search_companies

Search for companies in TheMovieDB by their original and alternative names. Returns: id, logo_path, name, origin_country, adult, backdrop_path, title, original_language, original_title, overview, poster_path, media_type, genre_ids, popularity, release_date, video, vote_average, vote_count. Required: query.

list_all_the_movie_database_tmdb_search_keywords

Search for keywords by their name in The Movie Database (themoviedb). Returns: id, name, adult, backdrop_path, title, original_language, original_title, overview, poster_path, media_type, genre_ids, popularity, release_date, video, vote_average, vote_count. Required: query.

list_all_the_movie_database_tmdb_search_movies

Search for movies on The Movie Database (themoviedb) by their original, translated, and alternative titles. Returns: adult, backdrop_path, genre_ids, id, original_language, original_title, overview, popularity, poster_path, release_date, title, video, vote_average, vote_count, media_type. Required: query.

list_all_the_movie_database_tmdb_search_multis

Search The Movie Database (themoviedb) for movies, TV shows, and people in a single request. Returns: adult, backdrop_path, id, title, original_language, original_title, overview, poster_path, media_type, genre_ids, popularity, release_date, video, vote_average, vote_count, name, original_name, first_air_date, origin_country. Result fields vary by media_type — movie results…. Required: query.

list_all_the_movie_database_tmdb_search_people

Search for people in TheMovieDB by their name and also-known-as names. Returns: adult, gender, id, known_for_department, name, original_name, popularity, profile_path, known_for. Required: query.

list_all_the_movie_database_tmdb_search_tvs

Search for TV shows in themoviedb by their original, translated, and also known as names. Returns: adult, backdrop_path, genre_ids, id, origin_country, original_language, original_name, overview, popularity, poster_path, first_air_date, name, vote_average, vote_count. Required: query.

list_all_the_movie_database_tmdb_trending_alls

List trending movies, TV shows, and people on The Movie DB for a given time window. Returns each item with id, media_type, title or name, overview, popularity, poster_path, vote_average, and vote_count; TV items also include first_air_date and origin_country, person items include gender, known_for_department, profile_path, and known_for. Required: time_window.

list_all_the_movie_database_tmdb_trending_movies

List trending movies on TMDB for a given time window. Returns: adult, backdrop_path, id, title, original_language, original_title, overview, poster_path, media_type, genre_ids, popularity, release_date, video, vote_average, vote_count. Required: time_window.

list_all_the_movie_database_tmdb_trending_people

List trending people on TMDB for a specified time window. Returns: adult, id, name, original_name, media_type, popularity, gender, known_for_department, profile_path, known_for. Required: time_window.

list_all_the_movie_database_tmdb_trending_tvs

List trending TV shows on The Movie Database (TMDB) for a given time window. Returns: adult, backdrop_path, id, name, original_language, original_name, overview, poster_path, media_type, genre_ids, popularity, first_air_date, vote_average, vote_count, origin_country. Required: time_window.

list_all_the_movie_database_tmdb_tv_airing_todays

List TV shows airing today from TheMovieDB. Returns: backdrop_path, first_air_date, genre_ids, id, name, origin_country, original_language, original_name, overview, popularity, poster_path, vote_average, vote_count. Optional: language, timezone.

list_all_the_movie_database_tmdb_tv_on_the_airs

List TV shows that air in the next 7 days from themoviedb. Returns: backdrop_path, first_air_date, genre_ids, id, name, origin_country, original_language, original_name, overview, popularity, poster_path, vote_average, vote_count.

list_all_the_movie_database_tmdb_tv_populars

List popular TV shows from TheMovieDB ordered by popularity. Returns each show with id, name, overview, popularity, vote_average, vote_count, first_air_date, genre_ids, origin_country, original_language, original_name, poster_path, and backdrop_path.

list_all_the_movie_database_tmdb_tv_top_rateds

List top-rated TV shows from themoviedb ordered by rating. Returns: backdrop_path, first_air_date, genre_ids, id, name, origin_country, original_language, original_name, overview, popularity, poster_path, vote_average, vote_count.

get_single_the_movie_database_tmdb_3_tv_by_id

Get the details of a specific TV show in themoviedb by id. Returns: adult, backdrop_path, created_by, episode_run_time, first_air_date, genres, homepage, id, in_production, languages, last_air_date, last_episode_to_air, next_episode_to_air, networks, number_of_episodes, number_of_seasons, origin_country, original_language, original_name, overview, popularity, poster_path, production_companies,…. Required: id.

list_all_the_movie_database_tmdb_aggregate_credits

Get the aggregate cast and crew credits for a TV show in TheMovieDB. Returns: cast, crew, id. Required: series_id.

list_all_the_movie_database_tmdb_content_ratings

List content ratings that have been added to a TV show in themoviedb. Returns the series id and a results array of per-country content ratings, each containing an ISO 3166-1 country code (iso_3166_1), the content rating string (rating), and a descriptors array. Required: series_id.

list_all_the_movie_database_tmdb_episode_groups

List episode groups that have been added to a TV show in themoviedb. Returns: results, id. Required: series_id.

list_all_the_movie_database_tmdb_tv_latests

Get the newest TV show added to themoviedb. Returns a single TV show object including id, name, original_name, overview, status, popularity, vote_average, vote_count, first_air_date, number_of_seasons, number_of_episodes, and nested episode and season details.

list_all_the_movie_database_tmdb_screened_theatricallies

List the seasons and episodes of a themoviedb TV series that have been screened theatrically. Returns the series id and a results array where each item contains id, episode_number, and season_number. Required: series_id.

get_single_the_movie_database_tmdb_tv_episode_group_by_id

Get the details of a TV episode group in TheMovieDB. Returns: description, episode_count, group_count, groups, id, network, type. Required: id.

list_all_the_movie_database_tmdb_providers_regions

List the countries that have watch provider (OTT/streaming) data available in themoviedb. Returns: results.

list_all_the_movie_database_tmdb_providers_movies

List streaming providers available for movies in The Movie Database. Returns each provider with provider_id, provider_name, logo_path, display_priority, and display_priorities.

list_all_the_movie_database_tmdb_providers_tvs

List streaming providers available for TV shows in themoviedb. Returns: results.

list_all_the_movie_database_tmdb_authentication_tokens

Create a new TMDB request token for the authentication flow. Returns: success, expires_at, request_token.

list_all_the_movie_database_tmdb_account_rated_movies

List movies rated by a themoviedb account user, including each user's personal rating. Returns: adult, backdrop_path, genre_ids, id, original_language, original_title, overview, popularity, poster_path, release_date, title, video, vote_average, vote_count, rating. Required: account_id.

list_all_the_movie_database_tmdb_account_rated_tvs

List TV shows rated by a TMDB account. Returns each rated TV show with its id, name, overview, first_air_date, poster_path, vote_average, vote_count, and the user's rating. Required: account_id.

list_all_the_movie_database_tmdb_account_rated_tv_episodes

List a user's rated TV episodes on TheMovieDB. Returns each episode's id, name, air_date, episode_number, season_number, show_id, rating, vote_average, vote_count, overview, still_path, production_code, and runtime. Required: account_id.

list_all_the_movie_database_tmdb_guest_rated_movies

List movies rated by a themoviedb guest session, ordered by the date the rating was created. Returns each rated movie with id, title, rating, vote_average, overview, poster_path, and release_date. Required: guest_session_id.

list_all_the_movie_database_tmdb_guest_rated_tvs

List TV shows rated by a guest session in TheMovieDB. Returns: adult, backdrop_path, genre_ids, id, origin_country, original_language, original_name, overview, popularity, poster_path, first_air_date, name, vote_average, vote_count, rating. Required: guest_session_id.

list_all_the_movie_database_tmdb_guest_rated_tv_episodes

List rated TV episodes for a TheMovieDB guest session. Returns each rated episode with id, name, air_date, episode_number, season_number, show_id, runtime, overview, still_path, vote_average, vote_count, production_code, and the guest's rating. Required: guest_session_id.

list_all_the_movie_database_tmdb_account_lists

List a TMDB user's custom lists. Returns: description, favorite_count, id, item_count, iso_639_1, list_type, name, poster_path. Required: account_id.

list_all_the_movie_database_tmdb_movie_certifications

List the officially supported movie certifications on TMDB, organized by country. Returns: certifications.g. AU, US, GB), where each entry contains the certification rating code, meaning, and sort order.

list_all_the_movie_database_tmdb_movie_genres

List the official movie genres on The Movie Database (themoviedb). Returns: genres.

the_movie_database_tmdb_tvs_alternative_titles

Get the alternative titles that have been added to a TV show in The Movie Database. Returns the show id and a results array where each entry contains an ISO 3166-1 country code, the alternative title text, and a type label (e.g. working title, common abbreviation, romanization). Required: series_id.

the_movie_database_tmdb_tvs_changes

Get the recent changes for a TV show in The Movie Database. Returns a changes array where each entry groups change items by key, with individual items including an id, action, timestamp, ISO language and country codes, and the new and original values for affected poster and backdrop images. Required: series_id.

the_movie_database_tmdb_tvs_credits

Get the cast and crew credits for a TV show in The Movie Database. Returns: cast, crew, id. Required: series_id.

the_movie_database_tmdb_tvs_external_ids

Get the external IDs linked to a themoviedb TV series, such as IMDb, TVDB, Wikidata, and social media identifiers. Returns: id, imdb_id, freebase_mid, freebase_id, tvdb_id, tvrage_id, wikidata_id, facebook_id, instagram_id, twitter_id. Required: series_id.

the_movie_database_tmdb_tvs_images

Get the images (backdrops, posters, and logos) that belong to a themoviedb TV series. Returns: backdrops, id, logos, posters. Required: series_id.

the_movie_database_tmdb_tvs_keywords

Get the keywords that have been added to a themoviedb TV series. Returns: id, results. Required: series_id.

the_movie_database_tmdb_tvs_lists

List the themoviedb user lists that a TV series has been added to. Returns: description, favorite_count, id, item_count, iso_639_1, iso_3166_1, name, poster_path. Required: series_id.

the_movie_database_tmdb_tvs_recommendations

List recommended TV series for a given themoviedb TV series. Returns: adult, backdrop_path, id, name, original_language, original_name, overview, poster_path, media_type, genre_ids, popularity, first_air_date, vote_average, vote_count, origin_country. Required: series_id.

the_movie_database_tmdb_tvs_reviews

List reviews that have been added to a TV show in themoviedb. Returns each review with author, author_details, content, created_at, id, updated_at, and url. Required: series_id.

the_movie_database_tmdb_tvs_similar

List TV shows similar to a given series in themoviedb. Returns each similar show with id, name, overview, poster_path, vote_average, vote_count, and more. Required: series_id.

the_movie_database_tmdb_tvs_translations

Get the translations that have been added to a TV show in themoviedb. Returns: id, translations. Required: series_id.

the_movie_database_tmdb_tvs_videos

Get the videos that belong to a TV show in TheMovieDB. Returns: iso_639_1, iso_3166_1, name, key, site, size, type, official, published_at, id. Required: series_id.

the_movie_database_tmdb_tvs_watch_providers

Get streaming providers for a TV show in themoviedb, organized by country. Returns: id, results. Required: series_id.

the_movie_database_tmdb_tvs_account_states

Get the account states (favorite, rated, and watchlist status) for a specific TV series in themoviedb. Returns: id, favorite, rated, watchlist. Required: series_id.

the_movie_database_tmdb_tvs_add_rating

Rate a TV show in themoviedb and save it to your rated list. Returns: status_code, status_message. Required: series_id, RAW_BODY.

the_movie_database_tmdb_tvs_delete_rating

Delete a user's rating for a TV series in themoviedb. Returns: status_code, status_message. Either session_id or guest_session_id must be supplied to identify the user. Required: series_id.

list_all_the_movie_database_tmdb_tv_seasons

Get details of a TV season in TheMovieDB by series and season number. Returns the season object including _id, air_date, episodes (each with crew and guest_stars), name, overview, id, poster_path, and season_number. Required: series_id, season_number.

the_movie_database_tmdb_tv_seasons_account_states

Get the rating, watchlist, and favourite status for episodes in a specific TV season on The Movie Database. Returns: id, results. Required: series_id, season_number.

the_movie_database_tmdb_tv_seasons_aggregate_credits

Get the aggregate cast and crew credits for a specific TV season in TheMovieDB. Returns: cast, crew, id. Required: series_id, season_number.

the_movie_database_tmdb_tv_seasons_changes

Get the recent changes for a TV season in The Movie Database. Returns: changes. Required: season_id.

the_movie_database_tmdb_tv_seasons_credits

Get the cast and crew credits for a TV season in TheMovieDB. Returns: cast, crew, id. Required: series_id, season_number.

the_movie_database_tmdb_tv_seasons_external_ids

Get the external IDs for a specific TV season on TheMovieDB. Returns: id, freebase_mid, freebase_id, tvdb_id, tvrage_id, wikidata_id. Required: series_id, season_number.

the_movie_database_tmdb_tv_seasons_images

Get the images that belong to a specific TV season on TheMovieDB. Returns: id, posters. Required: series_id, season_number.

the_movie_database_tmdb_tv_seasons_translations

Get the translations for a specific TV season on TheMovieDB. Returns: id, translations. Required: series_id, season_number.

the_movie_database_tmdb_tv_seasons_videos

Get the videos that belong to a specific TV season on TheMovieDB. Returns a list of video items with id, key, name, site, type, official, published_at, iso_639_1, iso_3166_1, and size. Required: series_id, season_number.

the_movie_database_tmdb_tv_seasons_watch_providers

Get the list of streaming, rental, and purchase providers for a specific TV season on TheMovieDB. Returns: id, results. Required: series_id, season_number.

list_all_the_movie_database_tmdb_tv_certifications

List TV content certifications (content ratings) available in themoviedb, organized by country. Returns the certifications map where each country code (e.g., AU, BR, CA) maps to an array of certification objects containing certification, meaning, and order.

list_all_the_movie_database_tmdb_tv_genres

List the official TV show genres available on themoviedb. Returns: genres. Accepts an optional language parameter to localize genre names.

the_movie_database_tmdb_people_changes

Get recent changes for a person on themoviedb. Returns: changes. Required: person_id.

the_movie_database_tmdb_people_external_ids

Get the external IDs that belong to a person in The Movie Database (TMDB). Returns: id, freebase_mid, freebase_id, imdb_id, tvrage_id, wikidata_id, facebook_id, instagram_id, tiktok_id, twitter_id, youtube_id. Required: person_id.

the_movie_database_tmdb_people_images

Get the profile images that belong to a person on themoviedb. Returns: id, profiles. Required: person_id.

the_movie_database_tmdb_people_translations

Get the translations that belong to a person in themoviedb. Returns: id, translations. Required: person_id.

the_movie_database_tmdb_companies_images

Get logos for a TMDB production company by company_id. Returns: id, logos. Required: company_id.

the_movie_database_tmdb_networks_alternative_names

Get the alternative names of a TV network in TheMovieDB. Returns the network id and a results array of alternative names, each containing a name and type field. Required: network_id.

the_movie_database_tmdb_networks_images

Get TV network logos by id in TheMovieDB. Returns the network id and a logos array of logo images, each with file_path, file_type, aspect_ratio, height, width, vote_average, and vote_count. Required: network_id.

Why Truto

Why use Truto’s MCP server for The Movie Database (TMDB)

Other MCP servers give you a static tool list for one app. Truto gives you a managed, multi-tenant MCP infrastructure across 650+ integrations.

01

Auto-generated, always up to date

Tools are dynamically generated from curated documentation — not hand-coded. As integrations evolve, tools stay current without manual maintenance.

02

Fine-grained access control

Scope each MCP server to read-only, write-only, specific methods, or tagged tool groups. Expose only what your AI agent needs — nothing more.

03

Multi-tenant by design

Each MCP server is scoped to a single connected account with its own credentials. The URL itself is the auth token — no shared secrets, no credential leaking across tenants.

04

Works with every MCP client

Standard JSON-RPC 2.0 protocol. Paste the URL into Claude, ChatGPT, Cursor, or any MCP-compatible agent framework — tools are discovered automatically.

05

Built-in auth, rate limits, and error handling

Tool calls execute through Truto’s proxy layer with automatic OAuth refresh, rate-limit handling, and normalized error responses. No raw API plumbing in your agent.

06

Expiring and auditable servers

Create time-limited MCP servers for contractors or automated workflows. Optional dual-auth requires both the URL and a Truto API token for high-security environments.

How It Works

From zero to integrated

Go live with The Movie Database (TMDB) in under an hour. No boilerplate, no maintenance burden.

01

Link your customer’s The Movie Database (TMDB) account

Use Truto’s frontend SDK to connect your customer’s The Movie Database (TMDB) account. We handle all OAuth and API key flows — you don’t need to create the OAuth app.

02

We handle authentication

Don’t spend time refreshing access tokens or figuring out secure storage. We handle it and inject credentials into every API request.

03

Call our API, we call The Movie Database (TMDB)

Truto’s Proxy API is a 1-to-1 mapping of the The Movie Database (TMDB) API. You call us, we call The Movie Database (TMDB), and pass the response back in the same cycle.

04

Unified response format

Every response follows a single format across all integrations. We translate The Movie Database (TMDB)’s pagination into unified cursor-based pagination. Data is always in the result attribute.

FAQs

Common questions about The Movie Database (TMDB) on Truto

Authentication, rate limits, data freshness, and everything else you need to know before you integrate.

How does authentication work for end-user TMDB accounts?

Truto handles TMDB's token-and-session auth flow: request an authentication token, have the user validate it (with login or approval), then exchange it for a session ID. Your app calls Truto with a connection reference and we attach the correct session credentials on every request. Session teardown is supported via the bulk delete endpoint.

Can I offer TMDB read-only access without asking end users to log in?

Yes. Catalog, search, discover, trending, images, translations, watch providers, and configuration endpoints work with API-key-level auth. User-scoped actions like creating watchlists, favorites, ratings, and personal lists require an authenticated session.

How do I keep a local copy of TMDB metadata fresh?

Use the movie changes, TV changes, and person changes endpoints to pull daily deltas rather than re-fetching entire records. Truto normalizes pagination so you can iterate change feeds and re-hydrate only affected IDs via the movie, TV, or person detail endpoints.

Is streaming availability (JustWatch) data available through this integration?

Yes. Watch provider endpoints for movies and TV, plus per-season watch providers and the providers regions/movies/TV listings, are all exposed. Results are keyed by ISO 3166-1 country code so you can render region-specific 'Watch Now' options.

What user-facing write operations are supported?

You can create favorites, create and manage custom lists (add items, remove items, clear, delete), add and delete movie and TV ratings, add and delete per-episode ratings, and manage watchlists. Guest session rated content is also readable for anonymous flows.

How does Truto handle TMDB's rate limits and pagination?

Truto manages retries, backoff, and pagination cursors under the hood, so your integration code stays declarative. TMDB's limits are generous for typical SaaS workloads; for large catalog syncs we recommend combining change endpoints with detail fetches rather than iterating the full catalog.

The Movie Database (TMDB)

Get The Movie Database (TMDB) integrated into your app

Our team understands what it takes to make a The Movie Database (TMDB) integration successful. A short, crisp 30 minute call with folks who understand the problem.