JustWatchAPI
JustWatch.com Python 3 API
Install
python3 -m pip install JustWatch
How To
search for an item
from justwatch import JustWatch
just_watch = JustWatch(country='US')
results = just_watch.search_for_item(query='the matrix')
or search for combination of genres
just_watch = JustWatch(genres=['act', 'scf', 'hrr'])
results_by_genres = just_watch.search_for_item()
or maybe search by provider
just_watch = JustWatch()
results_by_providers = just_watch.search_for_item(providers=['nfx', 'stn'])
or possibly a combination of the above
just_watch = JustWatch()
results_by_multiple = just_watch.search_for_item(
providers=['nfx', 'stn'],
content_types=['movie'],
monetization_types=['free'])
get list of genres and codes
just_watch = JustWatch(country='GB')
genre_details = just_watch.get_genres()
get list of providers for a country
just_watch = JustWatch(country='DE')
provider_details = just_watch.get_providers()
get further details on a movie or tv program
Based on title id found in previous search
just_watch = JustWatch(country='GB')
megamind = just_watch.get_title(title_id=103561)
dark = just_watch.get_title(title_id=55668, content_type='show')
get further defails on a specific season of a tv program
season_id
can be found in the response from get_title of a tv program
just_watch = JustWatch(country='GB')
hannibal_season2 = just_watch.get_season(season_id=20236)
get country specific certification details
just_watch = JustWatch(country='GB')
certs = just_watch.get_certifications()
content_type can be specified but (for GB at least) setting to 'show' gives less detail than the default of 'movie'
get cinema details
Setting "monetization_types" to "cinema"
and possibly setting nationwide_cinema_releases_only = True
will return a list of potential showings.
just_watch = JustWatch(country='GB')
cinema_showings = just_watch.search_for_item(monetization_types='cinema')
Then based on title_id obtained from that search
cinema_times = just_watch.get_cinema_times(title_id=this_title_id,
date='2018-03-24',
latitude=51.5287718,
longitude=-0.2416809,
radius=20000)
This will return details of all the showings in the area. Details of all the cinemas in the area can be obtained by a call to get_cinema_details()
. This takes the same latitutde, longitude and radius parameters as get_cinema_times()
, and if a call has already been made they'll be reused.
local_cinemas = just_watch.get_cinema_details()
You can then join the data from the two calls by joining 'cinema_id'
from get_cinema_times()
with 'id'
from get_cinema_details()
get upcoming cinema details
Call get_upcoming_cinema()
with number of weeks forward or back and whether you only require national releases
showings_last_week = just_watch.get_upcoming_cinema(weeks_offset=-1, nationwide_cinema_releases_only=True)
showings_three_weeks = just_watch.get_upcoming_cinema(weeks_offset=3, nationwide_cinema_releases_only=False)