18 TMDb Builders
meisnate12 edited this page 2 years ago

You can find items using the features of TheMovieDb.org (TMDb).

Standard TMDb Builders

Name Attribute Description Works with Movies Works with Shows Works with Playlists and Custom Sort
TMDb Collection tmdb_collection Finds every item in the TMDb collection ✔️
TMDb List tmdb_list Finds every item in the TMDb List ✔️ ✔️ ✔️
TMDb Actor tmdb_actor Finds every item in the TMDb Person's Actor Credits ✔️ ✔️
TMDb Crew tmdb_crew Finds every item in the TMDb Person's Crew Credits ✔️ ✔️
TMDb Director tmdb_director Finds every item in the TMDb Person's Director Credits ✔️ ✔️
TMDb Producer tmdb_producer Finds every item in the TMDb Person's Producer Credits ✔️ ✔️
TMDb Writer tmdb_writer Finds every item in the TMDb Person's Writer Credits ✔️ ✔️
TMDb Movie tmdb_movie Finds the movie specified ✔️
TMDb Show tmdb_show Finds the show specified ✔️
TMDb Company tmdb_company Finds every item from the TMDb company's movie/show list ✔️ ✔️
TMDb Network tmdb_network Finds every item from the TMDb network's show list ✔️
TMDb Keyword tmdb_keyword Finds every item from the TMDb keyword's movie/show list ✔️ ✔️

Standard TMDb Details Builders

Name Attribute Description Works with Movies Works with Shows Works with Playlists and Custom Sort
TMDb Collection Details tmdb_collection_details Finds every item in the TMDb collection and updates the collection with the summary, poster, and background from the TMDb collection ✔️
TMDb List Details tmdb_list_details Finds every item in the TMDb List and updates the collection with the description of the TMDb list ✔️ ✔️
TMDb Actor Details tmdb_actor_details Finds every item in the TMDb Person's Actor Credits with the biography and profile from the TMDb person ✔️ ✔️
TMDb Crew Details tmdb_crew_details Finds every item in the TMDb Person's Crew Credits with the biography and profile from the TMDb person ✔️ ✔️
TMDb Director Details tmdb_director_details Finds every item in the TMDb Person's Actor Credits with the biography and profile from the TMDb person ✔️ ✔️
TMDb Producer Details tmdb_producer_details Finds every item in the TMDb Person's Producer Credits with the biography and profile from the TMDb person ✔️ ✔️
TMDb Writer Details tmdb_writer_details Finds every item in the TMDb Person's Writer Credits with the biography and profile from the TMDb person ✔️ ✔️
TMDb Movie Details tmdb_movie_details Finds the movie specified and updates the collection with the summary, poster, and background from the TMDb movie ✔️
TMDb Show Details tmdb_show_details Finds the show specified and updates the collection with the summary, poster, and background from the TMDb show ✔️

Other TMDb Builders

Name Attribute Description Works with Movies Works with Shows Works with Playlists and Custom Sort
TMDb Popular tmdb_popular Finds the movies/shows in TMDb's Popular Movies/Popular Shows list ✔️ ✔️ ✔️
TMDb Now Playing tmdb_now_playing Finds the movies in TMDb's Now Playing list ✔️ ✔️
TMDb Top Rated tmdb_top_rated Finds the movies/shows in TMDb's Top Rated Movies/Top Rated Shows list ✔️ ✔️ ✔️
TMDb Trending Daily tmdb_trending_daily Finds the movies/shows in TMDb's Trending Daily list ✔️ ✔️ ✔️
TMDb Trending Weekly tmdb_trending_weekly Finds the movies/shows in TMDb's Trending Weekly list ✔️ ✔️ ✔️
TMDb Discover tmdb_discover Uses TMDb's Discover Search to find every movie/show based on the movie search parameters or show search parameters provided ✔️ ✔️ ✔️

Expected Input

The builders below are expected to have the full URL to the item or the TMDb ID of the item. Multiple values are supported as either a list or a comma-separated string.

The builders below are expected to have a single integer value of how many movies/shows to query.

TMDb Discover's attributes are detailed below.

TMDb Collection

Finds every item in the TMDb collection.

collections:
  The Lord of the Rings:
    tmdb_collection: https://www.themoviedb.org/collection/119
  The Hobbit:
    tmdb_collection: 121938
  Middle Earth:
    tmdb_collection:
      - 119
      - https://www.themoviedb.org/collection/121938
  • You can update the collection details with the TMDb collection's summary, poster, and background by using tmdb_collection_details.
  • You can specify multiple collections in tmdb_collection_details but it will only use the first one to update the collection details.
  • Posters and background in the library's asset directory will be used over the collection details unless tmdb_poster/tmdb_background is also specified.
collections:
  The Lord of the Rings:
    tmdb_collection_details: https://www.themoviedb.org/collection/119
  The Hobbit:
    tmdb_collection_details: 121938
  Middle Earth:
    tmdb_collection_details:
      - 119
      - https://www.themoviedb.org/collection/121938

TMDb List

Finds every item in the TMDb List.

The sync_mode: sync and collection_order: custom Details are recommended since the lists are continuously updated and in a specific order.

collections:
  Top 50 Grossing Films of All Time (Worldwide):
    tmdb_list: https://www.themoviedb.org/list/10
    collection_order: custom
    sync_mode: sync
collections:
  Top 50 Grossing Films of All Time (Worldwide):
    tmdb_list: 10
    collection_order: custom
    sync_mode: sync
  • You can update the collection details with the TMDb list's description by using tmdb_list_details.
  • You can specify multiple lists in tmdb_list_details but it will only use the first one to update the collection details.
collections:
  Top 50 Grossing Films of All Time (Worldwide):
    tmdb_list_details: 10

TMDb Actor

Finds every item in the TMDb Person's Actor Credits.

collections:
  Robin Williams:
    tmdb_actor: https://www.themoviedb.org/person/2157-robin-williams
collections:
  Robin Williams:
    tmdb_actor: 2157
  • You can update the collection details with the TMDb Person's biography and profile by using tmdb_actor_details.
  • You can specify multiple people in tmdb_actor_details but it will only use the first one to update the collection details.
collections:
  Robin Williams:
    tmdb_actor_details: 2157

TMDb Crew

Finds every item in the TMDb Person's Crew Credits.

collections:
  Quentin Tarantino:
    tmdb_crew: https://www.themoviedb.org/person/138-quentin-tarantino
collections:
  Quentin Tarantino:
    tmdb_crew: 138
  • You can update the collection details with the TMDb Person's biography and profile by using tmdb_crew_details.
  • You can specify multiple people in tmdb_crew_details but it will only use the first one to update the collection details.
collections:
  Quentin Tarantino:
    tmdb_crew_details: 138

TMDb Director

Finds every item in the TMDb Person's Director Credits.

collections:
  Steven Spielberg:
    tmdb_director: https://www.themoviedb.org/person/488-steven-spielberg
collections:
  Steven Spielberg:
    tmdb_director: 488
  • You can update the collection details with the TMDb Person's biography and profile by using tmdb_director_details.
  • You can specify multiple people in tmdb_director_details but it will only use the first one to update the collection details.
collections:
  Steven Spielberg:
    tmdb_director_details: 488

TMDb Producer

Finds every item in the TMDb Person's Producer Credits.

collections:
  Adam Sandler:
    tmdb_producer: https://www.themoviedb.org/person/19292-adam-sandler
collections:
  Adam Sandler:
    tmdb_producer: 19292
  • You can update the collection details with the TMDb Person's biography and profile by using tmdb_producer_details.
  • You can specify multiple people in tmdb_producer_details but it will only use the first one to update the collection details.
collections:
  Adam Sandler:
    tmdb_producer_details: 19292

TMDb Writer

Finds every item in the TMDb Person's Writer Credits.

collections:
  Woody Allen:
    tmdb_writer: https://www.themoviedb.org/person/1243-woody-allen
collections:
  Woody Allen:
    tmdb_writer: 1243
  • You can update the collection details with the TMDb Person's biography and profile by using tmdb_writer_details.
  • You can specify multiple people in tmdb_writer_details but it will only use the first one to update the collection details.
collections:
  Woody Allen:
    tmdb_writer_details: 1243

TMDb Movie

Finds the movie specified.

collections:
  Anaconda:
    tmdb_collection: https://www.themoviedb.org/collection/105995
    tmdb_movie: https://www.themoviedb.org/movie/336560
collections:
  Anaconda:
    tmdb_collection: 105995
    tmdb_movie: 336560
  • You can update the collection details with the TMDb movie's summary, poster, and background by using tmdb_movie_details.
  • You can specify multiple movies in tmdb_movie_details but it will only use the first one to update the collection details.
  • Posters and background in the library's asset directory will be used over the collection details unless tmdb_poster/tmdb_background is also specified.
collections:
  Anaconda:
    tmdb_collection: 105995
    tmdb_movie_details: 336560

TMDb Show

Finds the show specified.

collections:
  Star Wars (Animated Shows):
    tmdb_show:
      - https://www.themoviedb.org/tv/4194-star-wars-the-clone-wars
      - https://www.themoviedb.org/tv/60554-star-wars-rebels
collections:
  Star Wars (Animated Shows):
    tmdb_show:
      - 4194
      - 60554
  • You can update the collection details with the TMDb show's summary, poster, and background by using tmdb_show_details.
  • You can specify multiple shows in tmdb_show_details but it will only use the first one to update the collection details.
  • Posters and background in the library's asset directory will be used over the collection details unless tmdb_poster/tmdb_background is also specified.
collections:
  Star Wars (Animated Shows):
    tmdb_show_details:
      - 4194
      - 60554

TMDb Company

Finds every movie from the TMDb company's movie list.

collections:
  Studio Ghibli:
    tmdb_company: 10342
collections:
  Studio Ghibli:
    tmdb_company: https://www.themoviedb.org/company/10342

TMDb Network

Finds every item from the TMDb network's movie/show list.

collections:
  CBS:
    tmdb_network: 16
collections:
  CBS:
    tmdb_network: https://www.themoviedb.org/network/16

TMDb Keyword

Finds every item from the TMDb keyword's movie/show list.

collections:
  Marvel Cinematic Universe:
    tmdb_keyword: 180547
collections:
  Marvel Cinematic Universe:
    tmdb_keyword: https://www.themoviedb.org/keyword/180547

Finds the movies/shows in TMDb's Popular Movies/Popular Shows list.

The sync_mode: sync and collection_order: custom Details are recommended since the lists are continuously updated and in a specific order.

collections:
  TMDb Popular:
    tmdb_popular: 30
    collection_order: custom
    sync_mode: sync

TMDb Now Playing

Finds the movies in TMDb's Now Playing list.

The sync_mode: sync and collection_order: custom Details are recommended since the lists are continuously updated and in a specific order.

collections:
  TMDb Now Playing:
    tmdb_now_playing: 30
    collection_order: custom
    sync_mode: sync

TMDb Top Rated

Finds the movies/shows in TMDb's Top Rated Movies/Top Rated Shows list.

The sync_mode: sync and collection_order: custom Details are recommended since the lists are continuously updated and in a specific order.

collections:
  TMDb Top Rated:
    tmdb_top_rated: 30
    collection_order: custom
    sync_mode: sync

Finds the movies/shows in TMDb's Trending Daily list.

The sync_mode: sync and collection_order: custom Details are recommended since the lists are continuously updated and in a specific order.

collections:
  TMDb Daily Trending:
    tmdb_trending_daily: 30
    collection_order: custom
    sync_mode: sync

Finds the movies/shows in TMDb's Trending Weekly list.

The sync_mode: sync and collection_order: custom Details are recommended since the lists are continuously updated and in a specific order.

collections:
  TMDb Weekly Trending:
    tmdb_trending_weekly: 30
    collection_order: custom
    sync_mode: sync

TMDb Discover

Uses TMDb's Discover Search to find every movie/show based on the movie search parameters or show search parameters provided

The sync_mode: sync and collection_order: custom Details are recommended since the lists are continuously updated and in a specific order.

Type Description
String Any number of alphanumeric characters
Integer Any whole number greater than zero i.e. 2, 10, 50
Number Any number greater than zero i.e. 2.5, 7.4, 9
Boolean Must be true or false
Date: MM/DD/YYYY Date that fits the specified format
Year: YYYY Year must be a 4 digit integer i.e. 1990

Discover Movies Parameters

Movie Parameters Description Type
limit Specify how many movies you want returned by the query. (default: 100) Integer
language Specify a language to query translatable fields with. (default: en-US) ([a-z]{2})-([A-Z]{2})
region Specify a ISO 3166-1 code to filter release dates. Must be uppercase. ^[A-Z]{2}$
sort_by Choose from one of the many available sort options. (default: popularity.desc) See sort options below
certification_country Used in conjunction with the certification parameter, use this to specify a country with a valid certification. String
certification Filter results with a valid certification from the certification_country parameter. String
certification.lte Filter and only include movies that have a certification that is less than or equal to the specified value. String
certification.gte Filter and only include movies that have a certification that is greater than or equal to the specified value. String
include_adult A filter and include or exclude adult movies. Boolean
include_video A filter and include or exclude videos. Boolean
primary_release_year A filter to limit the results to a specific primary release year. Year: YYYY
primary_release_date.gte Filter and only include movies that have a primary release date that is greater or equal to the specified value. Date: MM/DD/YYYY
primary_release_date.lte Filter and only include movies that have a primary release date that is less than or equal to the specified value. Date: MM/DD/YYYY
release_date.gte Filter and only include movies that have a release date (looking at all release dates) that is greater or equal to the specified value. Date: MM/DD/YYYY
release_date.lte Filter and only include movies that have a release date (looking at all release dates) that is less than or equal to the specified value. Date: MM/DD/YYYY
with_release_type Specify a comma (AND) or pipe (OR) separated value to filter release types by. (1: Premiere, 2: Theatrical (limited), 3: Theatrical, 4: Digital, 5: Physical, 6: TV) String
year A filter to limit the results to a specific year (looking at all release dates). Year: YYYY
vote_count.gte Filter and only include movies that have a vote count that is greater or equal to the specified value. Integer
vote_count.lte Filter and only include movies that have a vote count that is less than or equal to the specified value. Integer
vote_average.gte Filter and only include movies that have a rating that is greater or equal to the specified value. Number
vote_average.lte Filter and only include movies that have a rating that is less than or equal to the specified value. Number
with_cast A comma-separated list of person ID's. Only include movies that have one of the ID's added as an actor. String
with_crew A comma-separated list of person ID's. Only include movies that have one of the ID's added as a crew member. String
with_people A comma-separated list of person ID's. Only include movies that have one of the ID's added as either an actor or a crew member. String
with_companies A comma-separated list of production company ID's. Only include movies that have one of the ID's added as a production company. String
without_companies Filter the results to exclude the specific production companies you specify here. AND / OR filters are supported. String
with_genres Comma-separated value of genre ids that you want to include in the results. String
without_genres Comma-separated value of genre ids that you want to exclude from the results. String
with_keywords A comma-separated list of keyword ID's. Only includes movies that have one of the ID's added as a keyword. String
without_keywords Exclude items with certain keywords. You can comma and pipe separate these values to create an 'AND' or 'OR' logic. String
with_runtime.gte Filter and only include movies that have a runtime that is greater or equal to a value. Integer
with_runtime.lte Filter and only include movies that have a runtime that is less than or equal to a value. Integer
with_original_language Specify an ISO 639-1 string to filter results by their original language value. String
with_watch_providers A comma or pipe separated list of watch provider ID's. Combine this filter with watch_region in order to filter your results by a specific watch provider in a specific region. String
watch_region An ISO 3166-1 code. Combine this filter with with_watch_providers in order to filter your results by a specific watch provider in a specific region. String
with_watch_monetization_types In combination with watch_region, you can filter by monetization type. flatrate, free, ads, rent, buy

Discover Shows Parameters

Show Parameters Description Type
limit Specify how many movies you want to be returned by the query. (default: 100) Integer
language Specify a language to query translatable fields with. (default: en-US) ([a-z]{2})-([A-Z]{2})
sort_by Choose from one of the many available sort options. (default: popularity.desc) See sort options below
air_date.gte Filter and only include TV shows that have an air date (by looking at all episodes) that is greater or equal to the specified value. Date: MM/DD/YYYY
air_date.lte Filter and only include TV shows that have an air date (by looking at all episodes) that is less than or equal to the specified value. Date: MM/DD/YYYY
first_air_date.gte Filter and only include TV shows that have a original air date that is greater or equal to the specified value. Can be used in conjunction with the include_null_first_air_dates filter if you want to include items with no air date. Date: MM/DD/YYYY
first_air_date.lte Filter and only include TV shows that have a original air date that is less than or equal to the specified value. Can be used in conjunction with the include_null_first_air_dates filter if you want to include items with no air date. Date: MM/DD/YYYY
first_air_date_year Filter and only include TV shows that have an original air date year that equal to the specified value. Can be used in conjunction with the include_null_first_air_dates filter if you want to include items with no air date. Year: YYYY
include_null_first_air_dates Use this filter to include TV shows that don't have an air date while using any of the first_air_date filters. Boolean
timezone Used in conjunction with the air_date.gte/lte filter to calculate the proper UTC offset. (default: America/New_York) String
vote_count.gte Filter and only include TV that have a vote count that is greater or equal to the specified value. Integer
vote_count.lte Filter and only include TV that have a vote count that is less than or equal to the specified value. Integer
vote_average.gte Filter and only include TV that have a rating that is greater or equal to the specified value. Number
vote_average.lte Filter and only include TV that have a rating that is less than or equal to the specified value. Number
with_networks Comma-separated value of network ids that you want to include in the results. String
with_companies A comma-separated list of production company ID's. Only include movies that have one of the ID's added as a production company. String
without_companies Filter the results to exclude the specific production companies you specify here. AND / OR filters are supported. String
with_genres Comma-separated value of genre ids that you want to include in the results. String
without_genres Comma-separated value of genre ids that you want to exclude from the results. String
with_keywords A comma-separated list of keyword ID's. Only includes TV shows that have one of the ID's added as a keyword. String
without_keywords Exclude items with certain keywords. You can comma and pipe separate these values to create an 'AND' or 'OR' logic. String
with_runtime.gte Filter and only include TV shows with an episode runtime that is greater than or equal to a value. Integer
with_runtime.lte Filter and only include TV shows with an episode runtime that is less than or equal to a value. Integer
with_original_language Specify an ISO 639-1 string to filter results by their original language value. String
screened_theatrically Filter results to include items that have been screened theatrically. Boolean
with_watch_providers A comma or pipe separated list of watch provider ID's. Combine this filter with watch_region in order to filter your results by a specific watch provider in a specific region. String
watch_region An ISO 3166-1 code. Combine this filter with with_watch_providers in order to filter your results by a specific watch provider in a specific region. String
with_watch_monetization_types In combination with watch_region, you can filter by monetization type. flatrate, free, ads, rent, buy
with_status Filter TV shows by their status. 0: Returning Series, 1: Planned, 2: In Production, 3: Ended, 4: Cancelled, 5: Pilot)
with_type Filter TV shows by their type. 0: Documentary, 1: News, 2: Miniseries, 3: Reality, 4: Scripted, 5: Show, 6: Video)

Sort Options

Sort Option Movie Sort Show Sort
popularity.asc ✔️ ✔️
popularity.desc ✔️ ✔️
original_title.asc ✔️
original_title.desc ✔️
revenue.asc ✔️
revenue.desc ✔️
release_date.asc ✔️
release_date.desc ✔️
primary_release_date.asc ✔️
primary_release_date.desc ✔️
first_air_date.asc ✔️
first_air_date.desc ✔️
vote_average.asc ✔️ ✔️
vote_average.desc ✔️ ✔️
vote_count.asc ✔️
vote_count.desc ✔️
collections:
  Movies Released in October 2020:
    tmdb_discover:
      primary_release_date.gte: 10/01/2020
      primary_release_date.lte: 10/31/2020
collections:
  Popular Movies:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      sort_by: popularity.desc
collections:
  Highest Rated R Movies:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      certification_country: US
      certification: R
      sort_by: vote_average.desc
collections:
  Most Popular Kids Movies:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      certification_country: US
      certification.lte: G
      sort_by: popularity.desc
collections:
  Highest Rated Movies From 2010:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      primary_release_year: 2010
      sort_by: vote_average.desc
collections:
  Best Dramas From 2014:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      with_genres: 18
      primary_release_year: 2014
      sort_by: vote_average.desc
collections:
  Highest Rated Science Fiction Movies with Tom Cruise:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      with_genres: 878
      with_cast: 500
      sort_by: vote_average.desc
collections:
  Highest Grossing Comedy Movies with Will Ferrell:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      with_genres: 35
      with_cast: 23659
      sort_by: revenue.desc
collections:
  Top Rated Movies with Brad Pitt and Edward Norton:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      with_people: 287,819
      sort_by: vote_average.desc
collections:
  Popular Movies with David Fincher and Rooney Mara:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      with_people: 108916,7467
      sort_by: popularity.desc
collections:
  Top Rated Dramas:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      with_genres: 18
      sort_by: vote_average.desc
      vote_count.gte: 10
collections:
  Highest Grossing R Movies with Liam Neeson:
    collection_order: custom
    sync_mode: sync
    tmdb_discover:
      certification_country: US
      certification: R
      sort_by: revenue.desc
      with_cast: 3896