# JustWatch API: Get where to watch

> Finds where a movie or show can be watched in a country on JustWatch. Returns streaming, rental and purchase offers with prices, plus ratings and whether it is in cinemas.

Unofficial. Not affiliated with or endorsed by JustWatch.

- Page: https://fous.com/methods/justwatch.com/get-where-to-watch
- Method: `justwatch.com/get_where_to_watch`, version 1
- Website: justwatch.com
- Returns: title, type, year, ratings, cinema status, JustWatch link, offers (kind, service, price, currency, quality, link)
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `year` | integer | no | `2024` | Release year to distinguish titles, for example 2024. |
| `title` | string | yes | `"Dune: Part Two"` | Movie or show name, for example Dune: Part Two. |
| `country` | string | no |  | Country name or two-letter code, for example United States or US. Default "United States". |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "year": 2024,
  "title": "Dune: Part Two"
}
```

Its output:

```json
{
  "type": "movie",
  "year": 2024,
  "title": "Dune: Part Two",
  "offers": [
    {
      "kind": "subscription",
      "price": null,
      "watch_link": "https://watch.amazon.com/detail?gti=amzn1.dv.gti.9392c069-96f9-421b-ac7a-275308e1327a",
      "service_name": "HBO Max Amazon Channel",
      "currency_code": "USD",
      "video_quality": "4K"
    },
    {
      "kind": "subscription",
      "price": null,
      "watch_link": "https://tv.youtube.com/browse/UCaA-mkSqDa03ajlTEJzHa5w",
      "service_name": "YouTube TV",
      "currency_code": "USD",
      "video_quality": "4K"
    },
    {
      "kind": "subscription",
      "price": null,
      "watch_link": "https://www.tntdrama.com/movies/dune-part-two-theatrical",
      "service_name": "TNT",
      "currency_code": "USD",
      "video_quality": "HD"
    }
  ],
  "imdb_rating": 8.4,
  "justwatch_id": "1133934",
  "in_cinemas_now": true,
  "justwatch_link": "https://www.justwatch.com/us/movie/dune-part-two-2023",
  "justwatch_rating_percent": 95
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"justwatch.com/get_where_to_watch","input":{"year":2024,"title":"Dune: Part Two"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Where can I stream Dune: Part Two (2024) in the United States?
- Is Oppenheimer from 2023 available to rent or buy in the UK, and how much does it cost?
- Which streaming service has The Bear season 3 in Canada?
- Show me the rental prices and quality options for Past Lives (2023) in Australia on JustWatch.
- Is Poor Things (2023) still playing in cinemas, and where else can I watch it in Germany?

## Input schema

```json
{
  "type": "object",
  "required": [
    "title"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "description": "Release year to distinguish titles, for example 2024."
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "description": "Movie or show name, for example Dune: Part Two."
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country name or two-letter code, for example United States or US."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "title",
    "type",
    "in_cinemas_now",
    "justwatch_link",
    "offers"
  ],
  "properties": {
    "type": {
      "enum": [
        "movie",
        "show"
      ],
      "type": "string"
    },
    "year": {
      "type": [
        "integer",
        "null"
      ]
    },
    "title": {
      "type": "string"
    },
    "offers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "enum": [
              "subscription",
              "free",
              "free with ads",
              "rent",
              "buy"
            ],
            "type": "string"
          },
          "price": {
            "type": [
              "number",
              "null"
            ]
          },
          "watch_link": {
            "type": [
              "string",
              "null"
            ]
          },
          "service_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "currency_code": {
            "type": [
              "string",
              "null"
            ]
          },
          "video_quality": {
            "enum": [
              "SD",
              "HD",
              "4K",
              null
            ],
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    },
    "imdb_rating": {
      "type": [
        "number",
        "null"
      ]
    },
    "justwatch_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "in_cinemas_now": {
      "type": "boolean"
    },
    "justwatch_link": {
      "type": "string"
    },
    "justwatch_rating_percent": {
      "type": [
        "integer",
        "null"
      ]
    }
  }
}
```

## See more

- [JustWatch API: List streaming chart titles](https://fous.com/methods/justwatch.com/list-streaming-charts.md): Lists titles on JustWatch's daily streaming chart for a country, optionally limited to one streaming service.
- [JustWatch API: List new arrivals](https://fous.com/methods/justwatch.com/list-new-arrivals.md): Lists recently added movies and show seasons on streaming services in a country, newest first, from JustWatch listings.
- [themoviedb.org API: Get movie details](https://fous.com/methods/themoviedb.org/get-movie.md): Finds a movie on TMDB by exact title (optionally its release year) or by TMDB movie link, and returns its details, cast, crew, trailers, and the release date, age rating and streaming services for a chosen country.
- [Netflix API: Get movie or show](https://fous.com/methods/netflix.com/get-movie-or-show.md): Gets one Netflix movie or series by its exact name or Netflix title URL: title details, publicly shown seasons and episodes, and whether it is available in a given country's catalogue (checked against public JustWatch listings).
- [IMDb API: Get movie or show](https://fous.com/methods/imdb.com/get-movie-or-show.md): Gets a movie or TV show's IMDb details from its name, IMDb title link or title ID; a year picks between titles with the same name. Unavailable details are null.
- [Rotten Tomatoes API: Get scores](https://fous.com/methods/rottentomatoes.com/get-scores.md): Gets Rotten Tomatoes critic and audience scores and title details for a movie or TV show, optionally for one TV season. Audience rating counts may be unavailable for series.
- [Box Office Mojo API: Get movie box office](https://fous.com/methods/boxofficemojo.com/get-movie-box-office.md): Finds a movie on Box Office Mojo by title, with an optional year, and returns its box office totals, release details, theater counts and markets.
- [IMDb API: Get IMDb Parents Guide](https://fous.com/methods/imdb.com/get-parents-guide.md): Gets age certifications and non-spoiler Parents Guide summaries (severity votes and example descriptions for five categories) for a movie or show by title, IMDb link or title ID. A year selects a specific release.
- [All JustWatch methods](https://fous.com/methods/justwatch.com.md)