# JustWatch

> Find where to stream, rent or buy any movie or show in 139 countries, see what is new, coming soon, cheaper or in the top charts on Netflix, Prime Video, Disney+ and hundreds of other services, and look up titles, seasons and episodes. No account needed.

App · 11 actions. Web page: https://docs.lodol.com/docs/integrations/justwatch

## Actions

### Find where to watch

Find every way to watch a movie or show in a country: the streaming services it is on, where it is free, and where to rent or buy it, with prices, picture quality and a link to each. Also gives the cheapest place to rent and to buy.

**Inputs**

- Movie or show (`title`, text, required): Its name (the best match is used), its justwatch.com link, or its id from an earlier step.
- Country (`country`, text): Which country's catalog and prices to use. One of: `AL` (Albania), `DZ` (Algeria), `AD` (Andorra), `AO` (Angola), `AG` (Antigua and Barbuda), `AR` (Argentina), `AU` (Australia), `AT` (Austria), `AZ` (Azerbaijan), `BS` (Bahamas), and 129 more. Default: `US`.
- Ways to watch (`ways_to_watch`, list): Only these ways of watching. Choose none for all of them. One or more of: `subscription`, `free`, `ads` (Free with ads), `rent`, `buy`, `cinema` (In cinemas).
- Streaming service (`service`, text): Only this service. Leave empty for every service.
- Language (`language`, text): The language for titles and descriptions. One of: `en` (English), `ar` (Arabic), `az` (Azerbaijani), `be` (Belarusian), `bs` (Bosnian), `bg` (Bulgarian), `ca` (Catalan), `zh` (Chinese), `hr` (Croatian), `cs` (Czech), and 29 more. Default: `en`.

**Outputs**

- `cheapest_buy` (object): The cheapest place to buy it, if any
- `cheapest_rent` (object): The cheapest place to rent it, if any
- `count` (number): How many are listed
- `country` (text): The two-letter country code, e.g. US
- `country_name` (text): The country's name, e.g. United States
- `options` (list): One entry per service and way to watch: subscription first, then free, rent and buy
- `streaming_on` (list): The services it streams on with a subscription or for free
- `title` (object): The movie or show

**Example output**

```json
{
  "cheapest_buy": {
    "currency": "USD",
    "price": 9.99,
    "price_text": "$9.99",
    "service": "Apple TV Store",
    "url": "https://tv.apple.com/us/movie/inception/umc.cmc.6loas01ow0w4lkatxxloz7a6e"
  },
  "cheapest_rent": {
    "currency": "USD",
    "price": 4.99,
    "price_text": "$4.99",
    "service": "Apple TV Store",
    "url": "https://tv.apple.com/us/movie/inception/umc.cmc.6loas01ow0w4lkatxxloz7a6e"
  },
  "count": 2,
  "country": "US",
  "country_name": "United States",
  "options": [
    {
      "available_until": null,
      "currency": "USD",
      "price": 4.99,
      "price_text": "$4.99",
      "qualities": [
        "SD",
        "HD",
        "4K"
      ],
      "service": "Apple TV Store",
      "service_id": "itu",
      "service_logo_url": "https://images.justwatch.com/icon/338253243/s100/itunes.png",
      "url": "https://tv.apple.com/us/movie/inception/umc.cmc.6loas01ow0w4lkatxxloz7a6e",
      "way_to_watch": "rent",
      "way_to_watch_label": "Rent"
    },
    {
      "available_until": null,
      "currency": "USD",
      "price": 9.99,
      "price_text": "$9.99",
      "qualities": [
        "SD",
        "HD",
        "4K"
      ],
      "service": "Apple TV Store",
      "service_id": "itu",
      "service_logo_url": "https://images.justwatch.com/icon/338253243/s100/itunes.png",
      "url": "https://tv.apple.com/us/movie/inception/umc.cmc.6loas01ow0w4lkatxxloz7a6e",
      "way_to_watch": "buy",
      "way_to_watch_label": "Buy"
    }
  ],
  "streaming_on": [],
  "title": {
    "age_rating": "TV-14",
    "description": "A thief who steals corporate secrets through the use of dream-sharing technology is given the inverse task of planting an idea into the mind of a CEO, but his tragic past may doom the project and his team to disaster.",
    "genres": [
      "Action & Adventure",
      "Crime",
      "Mystery & Thriller",
      "Science-Fiction"
    ],
    "id": "tm92641",
    "imdb_id": "tt1375666",
    "imdb_rating": 8.8,
    "imdb_votes": 2880857,
    "justwatch_url": "https://www.justwatch.com/us/movie/inception",
    "poster_url": "https://images.justwatch.com/poster/302449148/s592/inception.jpg",
    "release_date": "2010-07-14",
    "runtime_minutes": 148,
    "title": "Inception",
    "tmdb_rating": 8.373,
    "type": "movie",
    "year": 2010
  }
}
```

### Get movie or show details

Get a movie's or show's details: summary, genres, runtime, age rating, IMDb and TMDB ratings, cast and directors, number of seasons, and the services it streams on in the chosen country.

**Inputs**

- Movie or show (`title`, text, required): Its name (the best match is used), its justwatch.com link, or its id from an earlier step.
- Country (`country`, text): Which country's catalog and prices to use. One of: `AL` (Albania), `DZ` (Algeria), `AD` (Andorra), `AO` (Angola), `AG` (Antigua and Barbuda), `AR` (Argentina), `AU` (Australia), `AT` (Austria), `AZ` (Azerbaijan), `BS` (Bahamas), and 129 more. Default: `US`.
- Language (`language`, text): The language for titles and descriptions. One of: `en` (English), `ar` (Arabic), `az` (Azerbaijani), `be` (Belarusian), `bs` (Bosnian), `bg` (Bulgarian), `ca` (Catalan), `zh` (Chinese), `hr` (Croatian), `cs` (Czech), and 29 more. Default: `en`.

**Outputs**

- `country` (text): The two-letter country code, e.g. US
- `country_name` (text): The country's name, e.g. United States
- `title` (object): The movie or show

**Example output**

```json
{
  "country": "US",
  "country_name": "United States",
  "title": {
    "age_rating": "TV-14",
    "cast": [
      {
        "character": "Dom Cobb",
        "name": "Leonardo DiCaprio"
      },
      {
        "character": "Arthur",
        "name": "Joseph Gordon-Levitt"
      }
    ],
    "description": "A thief who steals corporate secrets through the use of dream-sharing technology is given the inverse task of planting an idea into the mind of a CEO, but his tragic past may doom the project and his team to disaster.",
    "directors": [
      "Christopher Nolan"
    ],
    "genres": [
      "Action & Adventure",
      "Crime",
      "Mystery & Thriller",
      "Science-Fiction"
    ],
    "id": "tm92641",
    "imdb_id": "tt1375666",
    "imdb_rating": 8.8,
    "imdb_votes": 2880857,
    "justwatch_url": "https://www.justwatch.com/us/movie/inception",
    "poster_url": "https://images.justwatch.com/poster/302449148/s592/inception.jpg",
    "production_countries": [
      "GB",
      "US"
    ],
    "release_date": "2010-07-14",
    "runtime_minutes": 148,
    "season_count": null,
    "streaming_on": [],
    "title": "Inception",
    "tmdb_rating": 8.373,
    "type": "movie",
    "year": 2010
  }
}
```

### Get top charts

Get JustWatch's streaming charts for a country: the most watched movies or shows today, this week or this month, with each one's rank, whether it is going up or down, and how long it has been in the top 10.

**Inputs**

- Country (`country`, text): Which country's catalog and prices to use. One of: `AL` (Albania), `DZ` (Algeria), `AD` (Andorra), `AO` (Angola), `AG` (Antigua and Barbuda), `AR` (Argentina), `AU` (Australia), `AT` (Austria), `AZ` (Azerbaijan), `BS` (Bahamas), and 129 more. Default: `US`.
- Movies or shows (`title_type`, text): Which chart: movies or shows. One of: `movie` (Movies), `show` (Shows). Default: `movie`.
- Period (`period`, text): Today's, this week's or this month's chart. One of: `daily` (Today (default)), `weekly` (This week), `monthly` (This month). Default: `daily`.
- Streaming service (`service`, text): Only titles on this service, keeping their place in the overall chart. Leave empty for the whole chart.
- How many (`limit`, number): How many places, 1 to 100. Defaults to 10. From 1 to 100. Default: `10`.
- Language (`language`, text): The language for titles and descriptions. One of: `en` (English), `ar` (Arabic), `az` (Azerbaijani), `be` (Belarusian), `bs` (Bosnian), `bg` (Bulgarian), `ca` (Catalan), `zh` (Chinese), `hr` (Croatian), `cs` (Czech), and 29 more. Default: `en`.

**Outputs**

- `count` (number): How many are listed
- `country` (text): The two-letter country code, e.g. US
- `country_name` (text): The country's name, e.g. United States
- `entries` (list): The chart, top first
- `period` (text): daily, weekly or monthly
- `title_type` (text): movie or show

**Example output**

```json
{
  "count": 1,
  "country": "US",
  "country_name": "United States",
  "entries": [
    {
      "age_rating": "TV-14",
      "best_rank": 1,
      "days_in_top_10": 6,
      "description": "A thief who steals corporate secrets through the use of dream-sharing technology is given the inverse task of planting an idea into the mind of a CEO, but his tragic past may doom the project and his team to disaster.",
      "genres": [
        "Action & Adventure",
        "Crime",
        "Mystery & Thriller",
        "Science-Fiction"
      ],
      "id": "tm92641",
      "imdb_id": "tt1375666",
      "imdb_rating": 8.8,
      "imdb_votes": 2880857,
      "justwatch_url": "https://www.justwatch.com/us/movie/inception",
      "position": 1,
      "poster_url": "https://images.justwatch.com/poster/302449148/s592/inception.jpg",
      "rank": 1,
      "rank_change": 2,
      "release_date": "2010-07-14",
      "runtime_minutes": 148,
      "title": "Inception",
      "tmdb_rating": 8.373,
      "trend": "up",
      "type": "movie",
      "year": 2010
    }
  ],
  "period": "daily",
  "title_type": "movie"
}
```

### List coming soon

List the movies, shows and new seasons announced to arrive on streaming services in a country soon, soonest first, with the day each arrives.

**Inputs**

- Country (`country`, text): Which country's catalog and prices to use. One of: `AL` (Albania), `DZ` (Algeria), `AD` (Andorra), `AO` (Angola), `AG` (Antigua and Barbuda), `AR` (Argentina), `AU` (Australia), `AT` (Austria), `AZ` (Azerbaijan), `BS` (Bahamas), and 129 more. Default: `US`.
- Streaming service (`service`, text): Only titles on this service. Leave empty for every service.
- Movies or shows (`title_type`, text): Only movies, only shows, or both. One of: `any` (Movies and shows), `movie` (Movies), `show` (Shows). Default: `any`.
- How many (`limit`, number): How many to list, 1 to 100. Defaults to 25. From 1 to 100. Default: `25`.
- Language (`language`, text): The language for titles and descriptions. One of: `en` (English), `ar` (Arabic), `az` (Azerbaijani), `be` (Belarusian), `bs` (Bosnian), `bg` (Bulgarian), `ca` (Catalan), `zh` (Chinese), `hr` (Croatian), `cs` (Czech), and 29 more. Default: `en`.

**Outputs**

- `count` (number): How many are listed
- `country` (text): The two-letter country code, e.g. US
- `country_name` (text): The country's name, e.g. United States
- `releases` (list): What is coming, soonest first
- `total_matches` (number): How many match in all, of which this lists the first

**Example output**

```json
{
  "count": 1,
  "country": "US",
  "country_name": "United States",
  "releases": [
    {
      "age_rating": null,
      "arrives_on": "2026-10-20",
      "description": "Weak, a washed-up cyberpunk legend, is now forced to live without chrome as he searches for a sense of purpose in a world that's passed him by.",
      "genres": [
        "Action & Adventure",
        "Animation",
        "Science-Fiction"
      ],
      "id": "tss568012",
      "imdb_id": null,
      "imdb_rating": 8.3,
      "imdb_votes": 87066,
      "justwatch_url": "https://www.justwatch.com/us/tv-show/cyberpunk-edgerunners/season-2",
      "poster_url": "https://images.justwatch.com/poster/337905378/s592/season-2.jpg",
      "release_date": "2026-10-20",
      "runtime_minutes": 26,
      "service": "Netflix",
      "service_id": "nfx",
      "show_id": "ts250831",
      "show_title": "Cyberpunk: Edgerunners",
      "title": "Season 2",
      "tmdb_rating": 8.5,
      "type": "season",
      "year": 2026
    }
  ],
  "total_matches": 91
}
```

### List episodes

List the episodes of one season of a show, with each one's title, summary, runtime and the day it first aired.

**Inputs**

- Show (`show`, text, required): The show's name (the best match is used), its justwatch.com link, or its id from an earlier step.
- Season (`season_number`, number, required): The season's number, such as 1. From 0 to 1000.
- Country (`country`, text): Which country's catalog and prices to use. One of: `AL` (Albania), `DZ` (Algeria), `AD` (Andorra), `AO` (Angola), `AG` (Antigua and Barbuda), `AR` (Argentina), `AU` (Australia), `AT` (Austria), `AZ` (Azerbaijan), `BS` (Bahamas), and 129 more. Default: `US`.
- Language (`language`, text): The language for titles and descriptions. One of: `en` (English), `ar` (Arabic), `az` (Azerbaijani), `be` (Belarusian), `bs` (Bosnian), `bg` (Bulgarian), `ca` (Catalan), `zh` (Chinese), `hr` (Croatian), `cs` (Czech), and 29 more. Default: `en`.

**Outputs**

- `count` (number): How many are listed
- `episodes` (list): Its episodes, in order
- `season` (object): The season
- `show` (object): The show

**Example output**

```json
{
  "count": 1,
  "episodes": [
    {
      "description": "A documentary crew arrives at the offices of Dunder Mifflin to observe the employees and learn about modern management.",
      "episode_number": 1,
      "id": "tse520068",
      "release_date": "2005-03-24",
      "runtime_minutes": 23,
      "season_number": 1,
      "title": "Pilot"
    }
  ],
  "season": {
    "id": "tss27124",
    "justwatch_url": "https://www.justwatch.com/us/tv-show/the-office-2005/season-1",
    "season_number": 1,
    "title": "Season 1"
  },
  "show": {
    "id": "ts22138",
    "justwatch_url": "https://www.justwatch.com/us/tv-show/the-office-2005",
    "title": "The Office"
  }
}
```

### List new arrivals

List the movies, shows and new seasons that arrived on streaming services in a country on one day, optionally only on one service, with how each can be watched and a link to it.

**Inputs**

- Country (`country`, text): Which country's catalog and prices to use. One of: `AL` (Albania), `DZ` (Algeria), `AD` (Andorra), `AO` (Angola), `AG` (Antigua and Barbuda), `AR` (Argentina), `AU` (Australia), `AT` (Austria), `AZ` (Azerbaijan), `BS` (Bahamas), and 129 more. Default: `US`.
- Streaming service (`service`, text): Only titles on this service. Leave empty for every service.
- Day (`date`, date): Which day's arrivals. Defaults to today.
- Movies or shows (`title_type`, text): Only movies, only shows, or both. One of: `any` (Movies and shows), `movie` (Movies), `show` (Shows). Default: `any`.
- Ways to watch (`ways_to_watch`, list): Only these ways of watching. Choose none for all of them. One or more of: `subscription`, `free`, `ads` (Free with ads), `rent`, `buy`, `cinema` (In cinemas).
- How many (`limit`, number): How many to list, 1 to 100. Defaults to 25. From 1 to 100. Default: `25`.
- Language (`language`, text): The language for titles and descriptions. One of: `en` (English), `ar` (Arabic), `az` (Azerbaijani), `be` (Belarusian), `bs` (Bosnian), `bg` (Bulgarian), `ca` (Catalan), `zh` (Chinese), `hr` (Croatian), `cs` (Czech), and 29 more. Default: `en`.

**Outputs**

- `arrivals` (list): What arrived
- `count` (number): How many are listed
- `country` (text): The two-letter country code, e.g. US
- `country_name` (text): The country's name, e.g. United States
- `date` (text): The day listed, YYYY-MM-DD
- `total_matches` (number): How many match in all, of which this lists the first

**Example output**

```json
{
  "arrivals": [
    {
      "age_rating": null,
      "currency": "USD",
      "description": "Weak, a washed-up cyberpunk legend, is now forced to live without chrome as he searches for a sense of purpose in a world that's passed him by.",
      "genres": [
        "Action & Adventure",
        "Animation",
        "Science-Fiction"
      ],
      "id": "tss568012",
      "imdb_id": null,
      "imdb_rating": 8.3,
      "imdb_votes": 87066,
      "justwatch_url": "https://www.justwatch.com/us/tv-show/cyberpunk-edgerunners/season-2",
      "new_episodes": 16,
      "poster_url": "https://images.justwatch.com/poster/337905378/s592/season-2.jpg",
      "release_date": "2026-10-20",
      "runtime_minutes": 26,
      "service": "Netflix",
      "service_id": "nfx",
      "service_logo_url": "https://images.justwatch.com/icon/207360008/s100/netflix.png",
      "show_id": "ts250831",
      "show_title": "Outlander",
      "title": "Season 7",
      "tmdb_rating": 8.5,
      "type": "season",
      "watch_url": "https://www.netflix.com/title/70285581",
      "way_to_watch": "subscription",
      "way_to_watch_label": "Subscription",
      "year": 2026
    }
  ],
  "count": 1,
  "country": "US",
  "country_name": "United States",
  "date": "2026-10-19",
  "total_matches": 12
}
```

### List popular titles

List the movies and shows people are watching most in a country, optionally only on one service, in some genres or from some years, sorted by popularity, trend, IMDb rating, release year or name.

**Inputs**

- Country (`country`, text): Which country's catalog and prices to use. One of: `AL` (Albania), `DZ` (Algeria), `AD` (Andorra), `AO` (Angola), `AG` (Antigua and Barbuda), `AR` (Argentina), `AU` (Australia), `AT` (Austria), `AZ` (Azerbaijan), `BS` (Bahamas), and 129 more. Default: `US`.
- Streaming service (`service`, text): Only titles on this service. Leave empty for every service.
- Movies or shows (`title_type`, text): Only movies, only shows, or both. One of: `any` (Movies and shows), `movie` (Movies), `show` (Shows). Default: `any`.
- Genres (`genres`, list): Only titles in any of these genres. One or more of: `act` (Action & Adventure), `ani` (Animation), `cmy` (Comedy), `crm` (Crime), `doc` (Documentary), `drm` (Drama), `fnt` (Fantasy), `hst` (History), `hrr` (Horror), `fml` (Kids & Family), and 9 more.
- Ways to watch (`ways_to_watch`, list): Only these ways of watching. Choose none for all of them. One or more of: `subscription`, `free`, `ads` (Free with ads), `rent`, `buy`, `cinema` (In cinemas).
- Released from (`released_from`, number): Only titles that came out in or after this year. From 1890 to 2100.
- Released until (`released_until`, number): Only titles that came out in or before this year. From 1890 to 2100.
- Sort by (`sort_by`, text): The order to list them in. One of: `popular` (Most popular (default)), `trending`, `imdb_score` (Highest IMDb rating), `release_year` (Newest first), `alphabetical` (A to Z). Default: `popular`.
- How many (`limit`, number): How many to list, 1 to 100. Defaults to 10. From 1 to 100. Default: `10`.
- Language (`language`, text): The language for titles and descriptions. One of: `en` (English), `ar` (Arabic), `az` (Azerbaijani), `be` (Belarusian), `bs` (Bosnian), `bg` (Bulgarian), `ca` (Catalan), `zh` (Chinese), `hr` (Croatian), `cs` (Czech), and 29 more. Default: `en`.

**Outputs**

- `count` (number): How many are listed
- `country` (text): The two-letter country code, e.g. US
- `country_name` (text): The country's name, e.g. United States
- `sort_by` (text): The order used
- `titles` (list): The titles, in that order
- `total_matches` (number): How many match in all, of which this lists the first

**Example output**

```json
{
  "count": 2,
  "country": "US",
  "country_name": "United States",
  "sort_by": "popular",
  "titles": [
    {
      "age_rating": "TV-14",
      "description": "A mockumentary on a group of typical office workers, where the workday consists of ego clashes, inappropriate behavior, tedium and romance.",
      "genres": [
        "Comedy"
      ],
      "id": "ts22138",
      "imdb_id": "tt0386676",
      "imdb_rating": 9,
      "imdb_votes": 855833,
      "justwatch_url": "https://www.justwatch.com/us/tv-show/the-office-2005",
      "poster_url": "https://images.justwatch.com/poster/305242125/s592/the-office-2005.jpg",
      "release_date": "2005-03-24",
      "runtime_minutes": 24,
      "title": "The Office",
      "tmdb_rating": 8.6,
      "type": "show",
      "year": 2005
    },
    {
      "age_rating": "TV-14",
      "description": "A thief who steals corporate secrets through the use of dream-sharing technology is given the inverse task of planting an idea into the mind of a CEO, but his tragic past may doom the project and his team to disaster.",
      "genres": [
        "Action & Adventure",
        "Crime",
        "Mystery & Thriller",
        "Science-Fiction"
      ],
      "id": "tm92641",
      "imdb_id": "tt1375666",
      "imdb_rating": 8.8,
      "imdb_votes": 2880857,
      "justwatch_url": "https://www.justwatch.com/us/movie/inception",
      "poster_url": "https://images.justwatch.com/poster/302449148/s592/inception.jpg",
      "release_date": "2010-07-14",
      "runtime_minutes": 148,
      "title": "Inception",
      "tmdb_rating": 8.373,
      "type": "movie",
      "year": 2010
    }
  ],
  "total_matches": 205300
}
```

### List price drops

List the movies and shows whose price to rent or buy dropped in a country on one day, with the new and the old price.

**Inputs**

- Country (`country`, text): Which country's catalog and prices to use. One of: `AL` (Albania), `DZ` (Algeria), `AD` (Andorra), `AO` (Angola), `AG` (Antigua and Barbuda), `AR` (Argentina), `AU` (Australia), `AT` (Austria), `AZ` (Azerbaijan), `BS` (Bahamas), and 129 more. Default: `US`.
- Streaming service (`service`, text): Only titles on this service. Leave empty for every service.
- Day (`date`, date): Which day's price drops. Defaults to today.
- Movies or shows (`title_type`, text): Only movies, only shows, or both. One of: `any` (Movies and shows), `movie` (Movies), `show` (Shows). Default: `any`.
- How many (`limit`, number): How many to list, 1 to 100. Defaults to 25. From 1 to 100. Default: `25`.
- Language (`language`, text): The language for titles and descriptions. One of: `en` (English), `ar` (Arabic), `az` (Azerbaijani), `be` (Belarusian), `bs` (Bosnian), `bg` (Bulgarian), `ca` (Catalan), `zh` (Chinese), `hr` (Croatian), `cs` (Czech), and 29 more. Default: `en`.

**Outputs**

- `count` (number): How many are listed
- `country` (text): The two-letter country code, e.g. US
- `country_name` (text): The country's name, e.g. United States
- `date` (text): The day listed, YYYY-MM-DD
- `price_drops` (list): The price drops
- `total_matches` (number): How many match in all, of which this lists the first

**Example output**

```json
{
  "count": 1,
  "country": "US",
  "country_name": "United States",
  "date": "2026-10-19",
  "price_drops": [
    {
      "age_rating": "TV-14",
      "currency": "USD",
      "description": "A thief who steals corporate secrets through the use of dream-sharing technology is given the inverse task of planting an idea into the mind of a CEO, but his tragic past may doom the project and his team to disaster.",
      "genres": [
        "Action & Adventure",
        "Crime",
        "Mystery & Thriller",
        "Science-Fiction"
      ],
      "id": "tm92641",
      "imdb_id": "tt1375666",
      "imdb_rating": 8.8,
      "imdb_votes": 2880857,
      "justwatch_url": "https://www.justwatch.com/us/movie/inception",
      "poster_url": "https://images.justwatch.com/poster/302449148/s592/inception.jpg",
      "previous_price": 14.99,
      "price": 9.99,
      "price_text": "$9.99",
      "release_date": "2010-07-14",
      "runtime_minutes": 148,
      "service": "Barnes & Noble",
      "service_id": "bnb",
      "service_logo_url": "https://images.justwatch.com/icon/335089140/s100/barnesandnoble.png",
      "title": "Inception",
      "tmdb_rating": 8.373,
      "type": "movie",
      "watch_url": "https://www.barnesandnoble.com/w/dvd-inception",
      "way_to_watch": "buy",
      "way_to_watch_label": "Buy",
      "year": 2010
    }
  ],
  "total_matches": 600
}
```

### List seasons

List a show's seasons, with how many episodes each has and the year it came out.

**Inputs**

- Show (`show`, text, required): The show's name (the best match is used), its justwatch.com link, or its id from an earlier step.
- Country (`country`, text): Which country's catalog and prices to use. One of: `AL` (Albania), `DZ` (Algeria), `AD` (Andorra), `AO` (Angola), `AG` (Antigua and Barbuda), `AR` (Argentina), `AU` (Australia), `AT` (Austria), `AZ` (Azerbaijan), `BS` (Bahamas), and 129 more. Default: `US`.
- Language (`language`, text): The language for titles and descriptions. One of: `en` (English), `ar` (Arabic), `az` (Azerbaijani), `be` (Belarusian), `bs` (Bosnian), `bg` (Bulgarian), `ca` (Catalan), `zh` (Chinese), `hr` (Croatian), `cs` (Czech), and 29 more. Default: `en`.

**Outputs**

- `count` (number): How many are listed
- `seasons` (list): Its seasons, first first
- `show` (object): The show

**Example output**

```json
{
  "count": 1,
  "seasons": [
    {
      "episode_count": 6,
      "id": "tss27124",
      "justwatch_url": "https://www.justwatch.com/us/tv-show/the-office-2005/season-1",
      "poster_url": "https://images.justwatch.com/poster/238556040/s592/season-1.jpg",
      "season_number": 1,
      "title": "Season 1",
      "year": 2005
    }
  ],
  "show": {
    "id": "ts22138",
    "justwatch_url": "https://www.justwatch.com/us/tv-show/the-office-2005",
    "title": "The Office"
  }
}
```

### List streaming services

List the streaming services, stores and free services JustWatch tracks in a country, with how each offers titles (subscription, free, rent, buy) and its logo.

**Inputs**

- Country (`country`, text): Which country's catalog and prices to use. One of: `AL` (Albania), `DZ` (Algeria), `AD` (Andorra), `AO` (Angola), `AG` (Antigua and Barbuda), `AR` (Argentina), `AU` (Australia), `AT` (Austria), `AZ` (Azerbaijan), `BS` (Bahamas), and 129 more. Default: `US`.
- Include add-on channels (`include_addons`, true/false): Also list channels sold inside other services, such as HBO Max Amazon Channel. Default: `false`.

**Outputs**

- `count` (number): How many are listed
- `country` (text): The two-letter country code, e.g. US
- `country_name` (text): The country's name, e.g. United States
- `services` (list): The services

**Example output**

```json
{
  "count": 2,
  "country": "US",
  "country_name": "United States",
  "services": [
    {
      "id": "nfx",
      "logo_url": "https://images.justwatch.com/icon/207360008/s100/netflix.png",
      "name": "Netflix",
      "ways_to_watch": [
        "subscription"
      ],
      "ways_to_watch_labels": [
        "Subscription"
      ]
    },
    {
      "id": "amp",
      "logo_url": "https://images.justwatch.com/icon/322992749/s100/amazonprime.png",
      "name": "Amazon Prime Video",
      "ways_to_watch": [
        "subscription",
        "free",
        "ads",
        "rent",
        "buy"
      ],
      "ways_to_watch_labels": [
        "Subscription",
        "Free",
        "Free with ads",
        "Rent",
        "Buy"
      ]
    }
  ]
}
```

### Search movies and shows

Find movies and shows by name, best match first, with their year, genres, ratings and the services they stream on in the chosen country.

**Inputs**

- Search for (`query`, text, required): A movie or show name, or part of one.
- Country (`country`, text): Which country's catalog and prices to use. One of: `AL` (Albania), `DZ` (Algeria), `AD` (Andorra), `AO` (Angola), `AG` (Antigua and Barbuda), `AR` (Argentina), `AU` (Australia), `AT` (Austria), `AZ` (Azerbaijan), `BS` (Bahamas), and 129 more. Default: `US`.
- Movies or shows (`title_type`, text): Only movies, only shows, or both. One of: `any` (Movies and shows), `movie` (Movies), `show` (Shows). Default: `any`.
- How many (`limit`, number): How many matches to return, 1 to 20. Defaults to 5. From 1 to 20. Default: `5`.
- Language (`language`, text): The language for titles and descriptions. One of: `en` (English), `ar` (Arabic), `az` (Azerbaijani), `be` (Belarusian), `bs` (Bosnian), `bg` (Bulgarian), `ca` (Catalan), `zh` (Chinese), `hr` (Croatian), `cs` (Czech), and 29 more. Default: `en`.

**Outputs**

- `count` (number): How many are listed
- `country` (text): The two-letter country code, e.g. US
- `country_name` (text): The country's name, e.g. United States
- `query` (text): What was searched for
- `titles` (list): The matches
- `total_matches` (number): How many match in all, of which this lists the first

**Example output**

```json
{
  "count": 1,
  "country": "US",
  "country_name": "United States",
  "query": "The Office",
  "titles": [
    {
      "age_rating": "TV-14",
      "description": "A mockumentary on a group of typical office workers, where the workday consists of ego clashes, inappropriate behavior, tedium and romance.",
      "genres": [
        "Comedy"
      ],
      "id": "ts22138",
      "imdb_id": "tt0386676",
      "imdb_rating": 9,
      "imdb_votes": 855833,
      "justwatch_url": "https://www.justwatch.com/us/tv-show/the-office-2005",
      "poster_url": "https://images.justwatch.com/poster/305242125/s592/the-office-2005.jpg",
      "release_date": "2005-03-24",
      "runtime_minutes": 24,
      "streaming_on": [
        "Peacock Premium",
        "YouTube TV",
        "TBS"
      ],
      "title": "The Office",
      "tmdb_rating": 8.6,
      "type": "show",
      "year": 2005
    }
  ],
  "total_matches": 6365
}
```
