TMDb Builders¶
You can find items using the features of TheMovieDb.org (TMDb).
Standard TMDb Builders¶
Attribute |
Description |
Works with Movies |
Works with Shows |
Works with Playlists and Custom Sort |
---|---|---|---|---|
Finds every item in the TMDb collection |
✅ |
❌ |
❌ |
|
Finds every item in the TMDb List |
✅ |
✅ |
✅ |
|
Finds every item in the TMDb Person’s Actor Credits |
✅ |
✅ |
❌ |
|
Finds every item in the TMDb Person’s Crew Credits |
✅ |
✅ |
❌ |
|
Finds every item in the TMDb Person’s Director Credits |
✅ |
✅ |
❌ |
|
Finds every item in the TMDb Person’s Producer Credits |
✅ |
✅ |
❌ |
|
Finds every item in the TMDb Person’s Writer Credits |
✅ |
✅ |
❌ |
|
Finds the movie specified |
✅ |
❌ |
❌ |
|
Finds the show specified |
❌ |
✅ |
❌ |
|
Finds every item from the TMDb company’s movie/show list |
✅ |
✅ |
❌ |
|
Finds every item from the TMDb network’s show list |
❌ |
✅ |
❌ |
|
Finds every item from the TMDb keyword’s movie/show list |
✅ |
✅ |
❌ |
Standard TMDb Details Builders¶
Attribute |
Description |
Works with Movies |
Works with Shows |
Works with Playlists and Custom Sort |
---|---|---|---|---|
Finds every item in the TMDb collection and updates the collection with the summary, poster, and background from the TMDb collection |
✅ |
❌ |
❌ |
|
Finds every item in the TMDb List and updates the collection with the description and poster of the TMDb list |
✅ |
✅ |
❌ |
|
Finds every item in the TMDb Person’s Actor Credits with the biography and profile from the TMDb person |
✅ |
✅ |
❌ |
|
Finds every item in the TMDb Person’s Crew Credits with the biography and profile from the TMDb person |
✅ |
✅ |
❌ |
|
Finds every item in the TMDb Person’s Actor Credits with the biography and profile from the TMDb person |
✅ |
✅ |
❌ |
|
Finds every item in the TMDb Person’s Producer Credits with the biography and profile from the TMDb person |
✅ |
✅ |
❌ |
|
Finds every item in the TMDb Person’s Writer Credits with the biography and profile from the TMDb person |
✅ |
✅ |
❌ |
|
Finds the movie specified and updates the collection with the summary, poster, and background from the TMDb movie |
✅ |
❌ |
❌ |
|
Finds the show specified and updates the collection with the summary, poster, and background from the TMDb show |
❌ |
✅ |
❌ |
Other TMDb Builders¶
Attribute |
Description |
Works with Movies |
Works with Shows |
Works with Playlists and Custom Sort |
---|---|---|---|---|
Finds the movies/shows in TMDb’s Popular Movies/Popular Shows list |
✅ |
✅ |
✅ |
|
Finds the movies in TMDb’s Now Playing list |
✅ |
❌ |
✅ |
|
Finds the movies/shows in TMDb’s Top Rated Movies/Top Rated Shows list |
✅ |
✅ |
✅ |
|
Finds the movies in TMDb’s Upcoming Movies list |
✅ |
❌ |
✅ |
|
Finds the shows in TMDb’s Airing Today Shows list |
❌ |
✅ |
✅ |
|
Finds the shows in TMDb’s On TV Shows list |
❌ |
✅ |
✅ |
|
Finds the movies/shows in TMDb’s Trending Daily list |
✅ |
✅ |
✅ |
|
Finds the movies/shows in TMDb’s Trending Weekly list |
✅ |
✅ |
✅ |
|
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:
Harry Potter:
tmdb_collection_details: 1241 #https://www.themoviedb.org/collection/1241 also accepted
Fantastic Beasts:
tmdb_collection_details: 435259 #https://www.themoviedb.org/collection/435259 also accepted
Wizarding World:
tmdb_collection_details:
- 1241
- https://www.themoviedb.org/collection/435259
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: 10 #https://www.themoviedb.org/list/10 also accepted
collection_order: custom
sync_mode: sync
You can update the collection details with the TMDb list’s description and poster 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:
Rotten Tomatoes Top 100 Movies of All Time:
tmdb_list_details: 3697 #themoviedb.org/list/3697 also accepted
TMDb Actor¶
Finds every item in the TMDb Person’s Actor Credits.
collections:
Robin Williams:
tmdb_actor: 2157 #https://www.themoviedb.org/person/2157-robin-williams also accepted
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:
Meryl Streep:
tmdb_actor_details: 5064
TMDb Crew¶
Finds every item in the TMDb Person’s Crew Credits.
collections:
Quentin Tarantino:
tmdb_crew: 138 #https://www.themoviedb.org/person/138-quentin-tarantino also accepted
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:
James Cameron:
tmdb_crew_details: 2710
TMDb Director¶
Finds every item in the TMDb Person’s Director Credits.
collections:
Steven Spielberg:
tmdb_director: 488 #https://www.themoviedb.org/person/488-steven-spielberg also accepted
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:
Sofia Coppola:
tmdb_director_details: 1769
TMDb Producer¶
Finds every item in the TMDb Person’s Producer Credits.
collections:
Adam Sandler:
tmdb_producer: 19292 #https://www.themoviedb.org/person/19292-adam-sandler also accepted
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:
Kathleen Kennedy:
tmdb_producer_details: 489
TMDb Writer¶
Finds every item in the TMDb Person’s Writer Credits.
collections:
Woody Allen:
tmdb_writer: 1243 #https://www.themoviedb.org/person/1243-woody-allen also accepted
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:
Tina Fey:
tmdb_writer_details: 56323
TMDb Movie¶
Finds the movie specified.
collections:
Anaconda:
tmdb_collection: 105995 #https://www.themoviedb.org/collection/105995 also accepted
tmdb_movie: 336560 #https://www.themoviedb.org/movie/336560 also accepted
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:
Deadpool Specials:
tmdb_collection: 567604
tmdb_movie_details: 558144
TMDb Show¶
Finds the show specified.
collections:
Star Wars (Animated Shows):
tmdb_show:
- 4194 #https://www.themoviedb.org/tv/4194-star-wars-the-clone-wars also accepted
- 60554 #https://www.themoviedb.org/tv/60554-star-wars-rebels also accepted
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:
Pokémon Evolutions & Chronicles:
tmdb_show_details:
- 132636
- 13230
TMDb Company¶
Finds every movie from the TMDb company’s movie list.
collections:
Studio Ghibli:
tmdb_company: 10342 #https://www.themoviedb.org/company/10342 also accepted
TMDb Network¶
Finds every item from the TMDb network’s movie/show list.
collections:
CBS:
tmdb_network: 16 #https://www.themoviedb.org/network/16 also accepted
TMDb Keyword¶
Finds every item from the TMDb keyword’s movie/show list.
collections:
Marvel Cinematic Universe:
tmdb_keyword: 180547 #https://www.themoviedb.org/keyword/180547 also accepted
TMDb Popular¶
Finds the movies/shows in TMDb’s Popular Movies/Popular Shows list.
Use tmdb_region
with this builder to set the region.
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.
Use tmdb_region
with this builder to set the region.
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.
Use tmdb_region
with this builder to set the region.
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
TMDb Upcoming¶
Finds the movies in TMDb’s Upcoming Movies list.
Use tmdb_region
with this builder to set the region.
The sync_mode: sync
and collection_order: custom
Details are recommended since the lists are continuously updated and in a specific order.
collections:
TMDb Upcoming:
tmdb_upcoming: 30
collection_order: custom
sync_mode: sync
TMDb Airing Today¶
Finds the shows in TMDb’s Airing Today 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 Airing Today:
tmdb_airing_today: 30
collection_order: custom
sync_mode: sync
TMDb On the Air¶
Finds the shows in TMDb’s On TV 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 On the Air:
tmdb_on_the_air: 30
collection_order: custom
sync_mode: sync
TMDb Trending Daily¶
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
TMDb Trending Weekly¶
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.
I’ve observed many attributes that begin with with_
or without_
being able to use |
as an OR
and &
as an AND
when specifying multiple items even though it’s not listed as possible.
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 |
Date: |
Date that fits the specified format |
Year: |
Year must be a 4 digit integer i.e. 1990 |
Discover Movies Parameters¶
Movie Parameters |
Description |
---|---|
|
Specify how many movies you want returned by the query. |
|
Specify a ISO 3166-1 code to filter release dates. Must be uppercase. Will use the |
|
Choose from one of the many available sort options. |
|
Used in conjunction with the certification parameter, use this to specify a country with a valid certification. |
|
Filter results with a valid certification from the |
|
Filter and only include movies that have a certification that is less than or equal to the specified value. |
|
Filter and only include movies that have a certification that is greater than or equal to the specified value. |
|
A filter and include or exclude adult movies. |
|
A filter and include or exclude videos. |
|
A filter to limit the results to a specific primary release year. |
|
Filter and only include movies that have a primary release date that is greater or equal to the specified value. |
|
Filter and only include movies that have a primary release date that is less than or equal to the specified value. |
|
Filter and only include movies that have a release date (looking at all release dates) that is greater or equal to the specified value. |
|
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. |
|
Specify a comma (AND) or pipe (OR) separated value to filter release types by. |
|
A filter to limit the results to a specific year (looking at all release dates). |
|
Filter and only include movies that have a vote count that is greater or equal to the specified value. |
|
Filter and only include movies that have a vote count that is less than or equal to the specified value. |
|
Filter and only include movies that have a rating that is greater or equal to the specified value. |
|
Filter and only include movies that have a rating that is less than or equal to the specified value. |
|
A comma-separated list of person ID’s. Only include movies that have one of the ID’s added as an actor. |
|
A comma-separated list of person ID’s. Only include movies that have one of the ID’s added as a crew member. |
|
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. |
|
A comma-separated list of production company ID’s. Only include movies that have one of the ID’s added as a production company. |
|
Filter the results to exclude the specific production companies you specify here. AND / OR filters are supported. |
|
Comma-separated value of genre ids that you want to include in the results. |
|
Comma-separated value of genre ids that you want to exclude from the results. |
|
A comma-separated list of keyword ID’s. Only includes movies that have one of the ID’s added as a keyword. |
|
Exclude items with certain keywords. You can comma and pipe separate these values to create an ‘AND’ or ‘OR’ logic. |
|
Filter and only include movies that have a runtime that is greater or equal to a value. |
|
Filter and only include movies that have a runtime that is less than or equal to a value. |
|
Specify an ISO 639-1 string to filter results by their original language value. |
|
Specify a language/country string to filter the results by if the item has a type of title translation. |
|
Specify a language/country string to filter the results by if the item has a type of overview translation. |
|
A comma or pipe separated list of watch provider ID’s. Combine this filter with |
|
An ISO 3166-1 code. Combine this filter with |
|
In combination with |
Discover Shows Parameters¶
Show Parameters |
Description |
---|---|
|
Specify how many movies you want to be returned by the query. |
|
Choose from one of the many available sort options. |
|
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. |
|
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. |
|
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 |
|
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 |
|
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 |
|
Use this filter to include TV shows that don’t have an air date while using any of the |
|
Used in conjunction with the |
|
Filter and only include TV that have a vote count that is greater or equal to the specified value. |
|
Filter and only include TV that have a vote count that is less than or equal to the specified value. |
|
Filter and only include TV that have a rating that is greater or equal to the specified value. |
|
Filter and only include TV that have a rating that is less than or equal to the specified value. |
|
Comma-separated value of network ids that you want to include in the results. |
|
A comma-separated list of production company ID’s. Only include movies that have one of the ID’s added as a production company. |
|
Filter the results to exclude the specific production companies you specify here. AND / OR filters are supported. |
|
Comma-separated value of genre ids that you want to include in the results. |
|
Comma-separated value of genre ids that you want to exclude from the results. |
|
A comma-separated list of keyword ID’s. Only includes TV shows that have one of the ID’s added as a keyword. |
|
Exclude items with certain keywords. You can comma and pipe separate these values to create an ‘AND’ or ‘OR’ logic. |
|
Filter and only include TV shows with an episode runtime that is greater than or equal to a value. |
|
Filter and only include TV shows with an episode runtime that is less than or equal to a value. |
|
Specify an ISO 639-1 string to filter results by their original language value. |
|
Specify a language/country string to filter the results by if the item has a type of name translation. |
|
Filter results to include items that have been screened theatrically. |
|
A comma or pipe separated list of watch provider ID’s. Combine this filter with |
|
An ISO 3166-1 code. Combine this filter with |
|
In combination with |
|
Filter TV shows by their status. |
|
Filter TV shows by their type. |
Sort Options¶
Sort Option |
Movie Sort |
Show Sort |
---|---|---|
|
✅ |
✅ |
|
✅ |
✅ |
|
✅ |
❌ |
|
✅ |
❌ |
|
✅ |
❌ |
|
✅ |
❌ |
|
✅ |
❌ |
|
✅ |
❌ |
|
✅ |
❌ |
|
✅ |
❌ |
|
❌ |
✅ |
|
❌ |
✅ |
|
✅ |
✅ |
|
✅ |
✅ |
|
✅ |
❌ |
|
✅ |
❌ |
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