Configuration

How to install the JustWatch Partner Widget?

Integration in 5 Steps (if you are using Wordpress, please follow our integration guide first before you proceed with the 5 steps):

  1. Add the widget HTML to your page:
<div data-jw-widget
     data-api-key="insert your unique API key. Leave the quotes" 
     data-object-type="insert either 'movie' or 'show'. Leave the quotes"
     data-title="insert movie or show title. Leave the quotes"            
     data-year="insert movie/show release year. Leave the quotes "
     data-theme="light"
></div>
  1. Add the Javascript (<script>) to your page:
<script async src="https://widget.justwatch.com/justwatch_widget.js"></script>

You should add it to the end of the <body> area of your webpage. If you cannot do that, it is also sufficient to add it right after the widget HTML

  1. Replace the value for data-api-key with the personal token you received
  2. Replace the values for data-title and data-year. (For other ways to specify which movie/show to display, check here)
  3. Add the branding below the widget HTML

How to configure the widget?

Three different options how to choose the movie/show to display in the widget.

JustWatch URL path

For the movie Forrest Gump you would find the title on justwatch.com and copy this URL path from the address bar in your browser: /us/movie/forrest-gump It doesn’t matter which country you are visiting from, the widget will recognize it (for example /de/Film/Forrest-Gump will be recognized as the same title)

Example:

<div data-jw-widget
     data-api-key="insert your unique API key. Leave the quotes"
     data-url-path="/us/movie/forrest-gump"
></div>

ID and ID type

If you have access to justwatch, imdb or tmdb ids, you can use them to display data for a specific title. The below example is for the movie Forrest Gump.

Example:

<div data-jw-widget
    data-api-key="insert your unique API key. Leave the quotes"
    data-object-type="movie"                 
    data-id="tt0109830"
    data-id-type="imdb"
></div>

Title and year

For the movie Forrest Gump you would find the title on justwatch.com and take the title and year from the page. The widget will try to match the provided object type, title and year to the correct movie/show It doesn’t matter which country you are visiting from, the widget will recognize any language.

Optionally for better matching results you can add a data-director attribute with one or more directors (separated by comma).

Example:

<div data-jw-widget
    data-api-key="insert your unique API key. Leave the quotes"
    data-object-type="movie"                 
    data-title="Forrest Gump"                 
    data-year="1994"
    data-director="Robert Zemeckis"
></div>

Branding and Linking to 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:

  • Branded Link should be displayed on the page next to every widget / “where to watch” integration and every page where the widget is displayed
  • 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)
  • The anchor text should be “JustWatch” with JustWatch wrapped in a img tag with alt text containing “JustWatch”
  • We prefer the JustWatch logo to be in gold, but black or white is fine as well (depending on the background)
  • This CodePen has an example of how the title page link should look like