Content Partner API

How to link to JustWatch?

JustWatch has a page for all titles in each supported country. When getting offers for a title, the API / data export also returns the full_path of the detail page on JustWatch.

Each partner is required to integrate branded links to the JustWatch website. Please find below an integration guide on how to link to JustWatch:

1. Branded Link should be displayed on the page next to every widget / “where to watch” integration and every page where the widget is displayed
2. The link should lead to the country specific sub-folder with the target film or tv show (https://www.justwatch.com/us/movie/the-pianist)
3. The anchor text should be “JustWatch” or JustWatch wrapped in a img tag with alt text containing “JustWatch”
4. We prefer the JustWatch logo to be in gold, but black or white is fine as well (depending on the background)
5. This CodePen have an example of how the title page link should look like: https://codepen.io/data-partner-JW/pen/JjBLgJK

How to make API Requests?

Once the contract is concluded, each partner is handed a unique partner token. This token is required for every request made to the JustWatch Partner API.

To make a request to the API, please follow these steps:

1. Use the Root URL: https://apis.justwatch.com/contentpartner/v2/content
2. To access a specific API route, append the API path to the end of the Root URL (API routes can be found below)
3. Insert the partner token as a query parameter

Example:

1. Root URL: https://apis.justwatch.com/contentpartner/v2/content
2. Sample API path to check the VOD availability for a title via a JustWatch ID:

https://apis.justwatch.com/contentpartner/v2/content/offers/object_type/movie/id_type/justwatch/id/<justwatch>/locale/en_US?token=<token>

3. Sample JustWatch ID: 266686, Partner Token: 123456
4. Final URL to make a request:

https://apis.justwatch.com/contentpartner/v2/content/offers/object_type/movie/id_type/justwatch/id/266686/locale/en_US?token=123456

API Reference

For the full interactive reference — every route, parameter, request/response schema, and example, generated straight from our OpenAPI specification — see the API Reference. You can also download the raw spec directly.

Notes

Upcoming Release Dates

For the movies and shows that have no offers yet, you will be able to get the upcoming release dates instead.

Frontend labels

The following table defines what the Frontend labels should look like depending on the release time frames shown in the response.

Types of Releases

• Digital Releases - Content that is initially released on streaming platforms.
• Re-releases - Previously released content is available again on streaming platforms.
• Theatrical Releases - Initial release of a movie in movie theaters/cinemas.

The Streaming Charts API

What is the Streaming Chart API?

JustWatch tracks the streaming popularity of movies and TV shows across various countries, updating the data on a daily, weekly, and monthly basis. This data is based on users on the JustWatch platform. We have integrated this information into our existing API, which assigns a rank to each title reflecting its streaming popularity. For example, a title ranked #1 signifies it being the most-streamed in a particular country across daily, weekly, and monthly metrics.

What sets this apart?

• It reflects real-time streaming trends.
• Our data is unique and updates in near real-time, unmatched elsewhere.
• Partners can easily add this to the movie and tv show pages with direct links, no additional branding required.

On our website, each movie and TV show page includes its current ranking in the streaming charts for easy reference. The feature is located just below the poster as well as in the table, you can check out a live example here.

What data do you get from the Streaming Charts API?

With the API, you will be able to retrieve the following data regarding a specific movie or TV show title:

• The streaming chart rank of a specific title on a daily (1d), weekly (7d), and monthly (30d) basis.
• The rank position change compared to the previous day, week, or month.

Data Attribution

Each partner is required to attribute the data and specify the source it’s coming from. Please find below an integration guide on how to do it:

JustWatch has a page for all titles in each supported country. When getting the rank for a title, the API also returns the full_path of the detail page on JustWatch.

1. The link should be displayed on the page, on every Rank appearance.
2. The link should lead to the country specific sub-folder with the target film or tv show (https://www.justwatch.com/us/movie/the-pianist)
3. The anchor text should be the rank itself (e.g. #1) with an optional JustWatch img tag with alt text containing “JustWatch”
4. This CodePen has an example of how the title page link should look like: https://codepen.io/data-partner-JW/pen/dyapvXR

For the route, parameters, and example payloads, see the Streaming Charts section of the API Reference.

WhyToWatch

Short “why to watch” blurbs for a title, written by JustWatch editors or sourced from celebrities, for partners who want to surface more than just streaming availability. Available per-title, per-season, or as a paginated feed of every title that currently has recommendations.

For the route, parameters, and example payloads, see the WhyToWatch section of the API Reference.

Tips

Experiencing CORS issues? When directly interacting from the browser, cross-server communication might get blocked. The simplest solution involves implementing a proxy that communicates with our server. By storing the token on the proxy side, it simplifies front-end requests and secures the token from exposure.

Test Data

Movies and Shows

JustWatch Partner API supports lookups by JustWatch ID and TMDb ID. The following is a sample list of movies and shows for easy access.

Locales

JustWatch data on movies and tv shows is available in the following locales