You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
154 lines
6.7 KiB
154 lines
6.7 KiB
# IMDb Builders
|
|
|
|
You can find items using the features of [IMDb.com](https://www.imdb.com/) (IMDb).
|
|
|
|
| Attribute | Description | Works with Movies | Works with Shows | Works with Playlists and Custom Sort |
|
|
|:------------------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------|:-----------------:|:----------------:|:------------------------------------:|
|
|
| [`imdb_id`](#imdb-id) | Gets the movie/show specified. | ✅ | ✅ | ❌ |
|
|
| [`imdb_chart`](#imdb-chart) | Gets every movie/show in an IMDb Chart like [IMDb Top 250 Movies](https://www.imdb.com/chart/top). | ✅ | ✅ | ✅ |
|
|
| [`imdb_list`](#imdb-list) | Gets every movie/show in an IMDb List, [IMDb Keyword Search](https://www.imdb.com/search/keyword/), or [IMDb Search](https://www.imdb.com/search/title/). | ✅ | ✅ | ✅ |
|
|
| [`imdb_watchlist`](#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.
|
|
|
|
```yaml
|
|
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](https://www.imdb.com/chart/boxoffice) | `box_office` | ✅ | ❌ |
|
|
| [Most Popular Movies](https://www.imdb.com/chart/moviemeter) | `popular_movies` | ✅ | ❌ |
|
|
| [Top 250 Movies](https://www.imdb.com/chart/top) | `top_movies` | ✅ | ❌ |
|
|
| [Top Rated English Movies](https://www.imdb.com/chart/top-english-movies) | `top_english` | ✅ | ❌ |
|
|
| [Most Popular TV Shows](https://www.imdb.com/chart/tvmeter) | `popular_shows` | ❌ | ✅ |
|
|
| [Top 250 TV Shows](https://www.imdb.com/chart/toptv) | `top_shows` | ❌ | ✅ |
|
|
| [Top Rated Indian Movies](https://www.imdb.com/india/top-rated-indian-movies/) | `top_indian` | ✅ | ❌ |
|
|
| [Lowest Rated Movies](https://www.imdb.com/chart/bottom) | `lowest_rated` | ✅ | ❌ |
|
|
|
|
```yaml
|
|
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](https://www.imdb.com/search/keyword/), [Title Search](https://www.imdb.com/search/title/), or [Topic Search](https://www.imdb.com/search/title-text/).
|
|
|
|
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.
|
|
|
|
```yaml
|
|
collections:
|
|
James Bonds:
|
|
imdb_list: https://www.imdb.com/list/ls006405458
|
|
collection_order: custom
|
|
sync_mode: sync
|
|
```
|
|
```yaml
|
|
collections:
|
|
IMDb Top 250:
|
|
imdb_list: https://www.imdb.com/search/title/?groups=top_250
|
|
collection_order: custom
|
|
sync_mode: sync
|
|
```
|
|
```yaml
|
|
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`.
|
|
|
|
```yaml
|
|
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.
|
|
|
|
```yaml
|
|
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.
|
|
|
|
```yaml
|
|
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.
|
|
|
|
```yaml
|
|
collections:
|
|
My Watch Watchlist:
|
|
imdb_watchlist: ur64054558
|
|
collection_order: custom
|
|
sync_mode: sync
|
|
```
|
|
```yaml
|
|
collections:
|
|
My Friends Watchlists:
|
|
imdb_watchlist: ur64054558, ur12345678
|
|
collection_order: custom
|
|
sync_mode: sync
|
|
```
|
|
```yaml
|
|
collections:
|
|
My Friends Watchlists:
|
|
imdb_watchlist:
|
|
- ur64054558
|
|
- ur12345678
|
|
collection_order: custom
|
|
sync_mode: sync
|
|
``` |