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 usUse Cases
Why integrate with The Movie Database (TMDB)
Common scenarios for SaaS companies building The Movie Database (TMDB) integrations for their customers.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.