--- title: The Movie Database (TMDB) API Integration on Truto slug: themoviedb category: Database canonical: "https://truto.one/integrations/detail/themoviedb/" --- # The Movie Database (TMDB) API Integration on Truto **Category:** Database **Status:** Beta ## MCP-ready AI tools Truto exposes 151 tools for The Movie Database (TMDB) that AI agents can call directly. - **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. ## How it works 1. **Link your customer's The Movie Database (TMDB) account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach The Movie Database (TMDB).** The Proxy API is a 1-to-1 mapping of the The Movie Database (TMDB) API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **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 - **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. ## FAQs ### 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.