Plex-Meta-Manager/docs/metadata/builders/imdb.md

IMDb Builders

You can find items using the features of IMDb.com (IMDb).

Attribute	Description	Works with Movies	Works with Shows	Works with Playlists and Custom Sort
imdb_id	Gets the movie/show specified.	✅	✅	❌
imdb_chart	Gets every movie/show in an IMDb Chart like IMDb Top 250 Movies.	✅	✅	✅
imdb_list	Gets every movie/show in an IMDb List, IMDb Keyword Search, or IMDb Search.	✅	✅	✅
imdb_watchlist	Gets every movie/show in an IMDb User's Watchlist.	✅	✅	✅

IMDb ID

Gets the movie/show specified.

The expected input is an IMDb ID. Multiple values are supported as either a list or a comma-separated string.

collections:
  Star Wars (Animated Shows):
    imdb_id: tt0458290, tt2930604

IMDb Chart

Finds every item in an IMDb Chart.

The expected input are the options below. Multiple values are supported as either a list or a comma-separated string.

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

Name	Attribute	Works with Movies	Works with Shows
Box Office	box_office	✅	❌
Most Popular Movies	popular_movies	✅	❌
Top 250 Movies	top_movies	✅	❌
Top Rated English Movies	top_english	✅	❌
Most Popular TV Shows	popular_shows	❌	✅
Top 250 TV Shows	top_shows	❌	✅
Top Rated Indian Movies	top_indian	✅	❌
Lowest Rated Movies	lowest_rated	✅	❌

collections:
  IMDb Top 250:
    imdb_chart: top_movies
    collection_order: custom
    sync_mode: sync

IMDb List

Finds every item in an IMDb List, Keyword Search, Title Search, or Topic Search.

The expected input is an IMDb List URL or IMDb Search URL. Multiple values are supported as a list only a comma-separated string will not work.

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

collections:
  James Bonds:
    imdb_list: https://www.imdb.com/list/ls006405458
    collection_order: custom
    sync_mode: sync

collections:
  IMDb Top 250:
    imdb_list: https://www.imdb.com/search/title/?groups=top_250
    collection_order: custom
    sync_mode: sync

collections:
  Christmas:
    imdb_list:
      - https://www.imdb.com/list/ls025976544/
      - https://www.imdb.com/list/ls003863000/
      - https://www.imdb.com/list/ls027454200/
      - https://www.imdb.com/list/ls027886673/
      - https://www.imdb.com/list/ls097998599/
    sync_mode: sync
    collection_order: alpha

You can also limit the number of items to search for by using the limit and url parameters under imdb_list.

collections:
  IMDb Popular:
    imdb_list:
      url: https://www.imdb.com/search/title/?title_type=feature,tv_movie,documentary,short
      limit: 50
    collection_order: custom
    sync_mode: sync

This can be used for multiple lists as seen below.

collections:
  Top Action:
    imdb_list:
      - url: https://www.imdb.com/search/title/?title_type=feature&release_date=1990-01-01,&user_rating=5.0,10.0&num_votes=100000,&genres=action
        limit: 100
      - url: https://www.imdb.com/search/title/?title_type=feature&release_date=1990-01-01,&user_rating=5.0,10.0&num_votes=100000,&genres=action&sort=user_rating,desc
        limit: 100

You can also find episodes using imdb_list like so.

collections:
  The Simpsons Top 100 Episodes:
    collection_order: custom
    builder_level: episode
    sync_mode: sync
    imdb_list:
      url: https://www.imdb.com/search/title/?series=tt0096697&sort=user_rating,desc
      limit: 100
    summary: The top 100 Simpsons episodes by IMDb user rating

IMDb Watchlist

Finds every item in an IMDb User's Watchlist.

The expected input is an IMDb User ID (example: ur12345678). Multiple values are supported as a list or as a comma-separated string.

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

collections:
  My Watch Watchlist:
    imdb_watchlist: ur64054558
    collection_order: custom
    sync_mode: sync

collections:
  My Friends Watchlists:
    imdb_watchlist: ur64054558, ur12345678
    collection_order: custom
    sync_mode: sync

collections:
  My Friends Watchlists:
    imdb_watchlist: 
      - ur64054558
      - ur12345678
    collection_order: custom
    sync_mode: sync