Package: simple-justwatch-python-api
Simple JustWatch Python APIA simple unofficial JustWatch Python API which usesGraphQLto access JustWatch data, built withhttpxandPython3.11.InstallationProject is available inPyPi:pipinstallsimple-justwatch-python-apiUsageCurrently, there's only one function available - search JustWatch:fromsimplejustwatchapi.justwatchimportsearchresults=search("title","US","en",5,True)Only the first argument is required, it specifies a title to search.Other arguments in order are:strcountry code to search for offers, have to be a 2-letter code, e.g.US,GB,FR, etc.
It should be uppercase, however lowercase codes are automatically converted to uppercase. By defaultUSis used.strlanguage code, usually 2-letter lowercase code, e.g.en,fr, etc. By defaultenis used.inthow many results should be returned. Actual response can contain fewer entries if fewer are found.
By default4is used.boolspecify if only best offers should be returned (True) or all offers (False).
By defaultTrueis used.Returned value is a list ofMediaEntryobjects:classMediaEntry(NamedTuple):entry_id:strobject_id:intobject_type:strtitle:strurl:strrelease_year:intrelease_date:strruntime_minutes:intshort_description:strgenres:list[str]imdb_id:str|Noneposter:str|Nonebackdrops:list[str]offers:list[Offer]classOffer(NamedTuple):monetization_type:strpresentation_type:strurl:strprice_string:str|Noneprice_value:float|Noneprice_currency:strname:strtechnical_name:stricon:strExample response:[MediaEntry(entry_id="tm10",object_id=10,object_type="MOVIE",title="The Matrix",url="https://justwatch.com/us/movie/the-matrix",release_year=1999,release_date="1999-03-30",runtime_minutes=136,short_description="Set in the 22nd century, The Matrix tells the story of a computer hacker...",genres=["act","scf"],imdb_id="tt0133093",poster="https://images.justwatch.com/poster/79353084/s718/the-matrix.jpg",backdrops=["https://images.justwatch.com/backdrop/240047406/s1920/the-matrix.jpg","https://images.justwatch.com/backdrop/104412692/s1920/the-matrix.jpg","https://images.justwatch.com/backdrop/8668185/s1920/the-matrix.jpg","https://images.justwatch.com/backdrop/104412689/s1920/the-matrix.jpg","https://images.justwatch.com/backdrop/177734824/s1920/the-matrix.jpg",],offers=[Offer(monetization_type="FLATRATE",presentation_type="HD",url="https://watch.amazon.com/detail?gti=amzn1.dv.gti.ed68472f-1421-417d-800b-0cfdb21db71c",price_string=None,price_value=None,price_currency="USD",name="Max Amazon Channel",technical_name="amazonhbomax",icon="https://images.justwatch.com/icon/305591736/s100/amazonhbomax.png",),Offer(monetization_type="FLATRATE",presentation_type="_4K",url="https://play.max.com/movie/012cacbd-5893-4379-b7a6-d3737c61d4b5",price_string=None,price_value=None,price_currency="USD",name="Max",technical_name="max",icon="https://images.justwatch.com/icon/305458112/s100/max.png",),Offer(monetization_type="RENT",presentation_type="_4K",url="https://tv.apple.com/us/movie/the-matrix/umc.cmc.af8k9kcq9r1s1qmmdxpq4itn?playableId=tvs.sbd.9001%3A271469518",price_string="$3.99",price_value=3.99,price_currency="USD",name="Apple TV",technical_name="itunes",icon="https://images.justwatch.com/icon/190848813/s100/itunes.png",),Offer(monetization_type="RENT",presentation_type="_4K",url="https://watch.amazon.com/detail?gti=amzn1.dv.gti.ed68472f-1421-417d-800b-0cfdb21db71c",price_string="$3.99",price_value=3.99,price_currency="USD",name="Amazon Video",technical_name="amazon",icon="https://images.justwatch.com/icon/430993/s100/amazon.png",),Offer(monetization_type="RENT",presentation_type="SD",url="https://play.google.com/store/movies/details/The_Matrix?gl=US&hl=en&id=ilPevtGe57s.P",price_string="$3.99",price_value=3.99,price_currency="USD",name="Google Play Movies",technical_name="play",icon="https://images.justwatch.com/icon/169478387/s100/play.png",),Offer(monetization_type="RENT",presentation_type="SD",url="https://www.youtube.com/results?search_query=The+Matrix%2Bmovie",price_string="$3.99",price_value=3.99,price_currency="USD",name="YouTube",technical_name="youtube",icon="https://images.justwatch.com/icon/59562423/s100/youtube.png",),Offer(monetization_type="RENT",presentation_type="_4K",url="https://www.vudu.com/content/movies/details/The-Matrix/9254",price_string="$3.99",price_value=3.99,price_currency="USD",name="Vudu",technical_name="vudu",icon="https://images.justwatch.com/icon/249324969/s100/vudu.png",),Offer(monetization_type="RENT",presentation_type="_4K",url="https://www.microsoft.com/en-us/p/the-matrix/8d6kgwzl5r09",price_string="$3.99",price_value=3.99,price_currency="USD",name="Microsoft Store",technical_name="microsoft",icon="https://images.justwatch.com/icon/820542/s100/microsoft.png",),Offer(monetization_type="RENT",presentation_type="_4K",url="https://www.directv.com/movies/The-Matrix-ZUF5bGQvemdYeVJ2L3lpNERBQ205QT09",price_string="$3.99",price_value=3.99,price_currency="USD",name="DIRECTV",technical_name="directv",icon="https://images.justwatch.com/icon/158260222/s100/directv.png",),Offer(monetization_type="RENT",presentation_type="HD",url="https://ondemand.spectrum.net/movies/22804/the-matrix/",price_string="$3.99",price_value=3.99,price_currency="USD",name="Spectrum On Demand",technical_name="spectrumondemand",icon="https://images.justwatch.com/icon/305635208/s100/spectrumondemand.png",),Offer(monetization_type="BUY",presentation_type="HD",url="http://www.amctheatres.com/movies/the-matrix-4111",price_string="$14.99",price_value=14.99,price_currency="USD",name="AMC on Demand",technical_name="amctheatresondemand",icon="https://images.justwatch.com/icon/166008757/s100/amctheatresondemand.png",),],),MediaEntry(entry_id="tm827124",object_id=827124,object_type="MOVIE",title="The Matrix Resurrections",url="https://justwatch.com/us/movie/the-matrix-resurrections",release_year=2021,release_date="2021-12-16",runtime_minutes=148,short_description="Plagued by strange memories, Neo's life takes an unexpected turn...",genres=["scf","act"],imdb_id="tt10838180",poster="https://images.justwatch.com/poster/257943908/s718/the-matrix-resurrections.jpg",backdrops=["https://images.justwatch.com/backdrop/245633536/s1920/the-matrix-resurrections.jpg","https://images.justwatch.com/backdrop/257943910/s1920/the-matrix-resurrections.jpg","https://images.justwatch.com/backdrop/257943914/s1920/the-matrix-resurrections.jpg","https://images.justwatch.com/backdrop/256148705/s1920/the-matrix-resurrections.jpg","https://images.justwatch.com/backdrop/257380502/s1920/the-matrix-resurrections.jpg",],offers=[Offer(monetization_type="FLATRATE",presentation_type="HD",url="https://www.hulu.com/watch/ab96e61c-6ad5-4a63-a7f9-77ff315de6e0",price_string=None,price_value=None,price_currency="USD",name="Hulu",technical_name="hulu",icon="https://images.justwatch.com/icon/116305230/s100/hulu.png",),Offer(monetization_type="FLATRATE",presentation_type="HD",url="https://watch.amazon.com/detail?gti=amzn1.dv.gti.bd6bd6ed-93ce-41f7-a06d-3a1277b94fcb",price_string=None,price_value=None,price_currency="USD",name="Max Amazon Channel",technical_name="amazonhbomax",icon="https://images.justwatch.com/icon/305591736/s100/amazonhbomax.png",),Offer(monetization_type="FLATRATE",presentation_type="_4K",url="https://play.max.com/movie/a553a6c7-66a0-42fc-8f6a-a47f926fe435",price_string=None,price_value=None,price_currency="USD",name="Max",technical_name="max",icon="https://images.justwatch.com/icon/305458112/s100/max.png",),Offer(monetization_type="FLATRATE",presentation_type="HD",url="https://www.tntdrama.com/movies/the-matrix-resurrections-theatrical",price_string=None,price_value=None,price_currency="USD",name="TNT",technical_name="tnt",icon="https://images.justwatch.com/icon/164147684/s100/tnt.png",),Offer(monetization_type="FLATRATE",presentation_type="HD",url="https://www.tbs.com/movies/the-matrix-resurrections-theatrical",price_string=None,price_value=None,price_currency="USD",name="TBS",technical_name="tbs",icon="https://images.justwatch.com/icon/209564793/s100/tbs.png",),Offer(monetization_type="FLATRATE",presentation_type="HD",url="https://www.trutv.com/movies/the-matrix-resurrections-theatrical",price_string=None,price_value=None,price_currency="USD",name="tru TV",technical_name="trutv",icon="https://images.justwatch.com/icon/209564918/s100/trutv.png",),Offer(monetization_type="RENT",presentation_type="_4K",url="https://watch.amazon.com/detail?gti=amzn1.dv.gti.bd6bd6ed-93ce-41f7-a06d-3a1277b94fcb",price_string="$3.79",price_value=3.79,price_currency="USD",name="Amazon Video",technical_name="amazon",icon="https://images.justwatch.com/icon/430993/s100/amazon.png",),Offer(monetization_type="RENT",presentation_type="_4K",url="https://tv.apple.com/us/movie/the-matrix-resurrections/umc.cmc.1xfut1sq2hvb9faupyabxog7q?playableId=tvs.sbd.9001%3A1595166379",price_string="$3.99",price_value=3.99,price_currency="USD",name="Apple TV",technical_name="itunes",icon="https://images.justwatch.com/icon/190848813/s100/itunes.png",),Offer(monetization_type="RENT",presentation_type="SD",url="https://play.google.com/store/movies/details/The_Matrix_Resurrections?gl=US&hl=en&id=aoFm38NvOCY.P",price_string="$3.99",price_value=3.99,price_currency="USD",name="Google Play Movies",technical_name="play",icon="https://images.justwatch.com/icon/169478387/s100/play.png",),Offer(monetization_type="RENT",presentation_type="SD",url="https://www.youtube.com/results?search_query=The+Matrix+Resurrections%2Bmovie",price_string="$3.99",price_value=3.99,price_currency="USD",name="YouTube",technical_name="youtube",icon="https://images.justwatch.com/icon/59562423/s100/youtube.png",),Offer(monetization_type="RENT",presentation_type="_4K",url="https://www.vudu.com/content/movies/details/The-Matrix-Resurrections/1907631",price_string="$3.99",price_value=3.99,price_currency="USD",name="Vudu",technical_name="vudu",icon="https://images.justwatch.com/icon/249324969/s100/vudu.png",),Offer(monetization_type="RENT",presentation_type="_4K",url="https://www.microsoft.com/en-us/p/the-matrix-resurrections/8d6kgwxn5rlr",price_string="$3.99",price_value=3.99,price_currency="USD",name="Microsoft Store",technical_name="microsoft",icon="https://images.justwatch.com/icon/820542/s100/microsoft.png",),Offer(monetization_type="RENT",presentation_type="_4K",url="https://www.directv.com/movies/The-Matrix-Resurrections-VDhidUx4QXRCTGw5M2wzditEMVM4QT09",price_string="$3.99",price_value=3.99,price_currency="USD",name="DIRECTV",technical_name="directv",icon="https://images.justwatch.com/icon/158260222/s100/directv.png",),Offer(monetization_type="RENT",presentation_type="HD",url="https://ondemand.spectrum.net/movies/18062455/the-matrix-resurrections/",price_string="$3.99",price_value=3.99,price_currency="USD",name="Spectrum On Demand",technical_name="spectrumondemand",icon="https://images.justwatch.com/icon/305635208/s100/spectrumondemand.png",),Offer(monetization_type="BUY",presentation_type="HD",url="http://www.amctheatres.com/movies/the-matrix-resurrections-62603",price_string="$14.99",price_value=14.99,price_currency="USD",name="AMC on Demand",technical_name="amctheatresondemand",icon="https://images.justwatch.com/icon/166008757/s100/amctheatresondemand.png",),],),MediaEntry(entry_id="tm11",object_id=11,object_type="MOVIE",title="The Matrix Reloaded",url="https://justwatch.com/us/movie/the-matrix-2-reloaded",release_year=2003,release_date="2003-05-15",runtime_minutes=129,short_description="Six months after the events depicted in The Matrix, Neo has proved to be a good omen...",genres=["scf","act"],imdb_id="tt0234215",poster="https://images.justwatch.com/poster/251725999/s718/the-matrix-2-reloaded.jpg",backdrops=["https://images.justwatch.com/backdrop/8721510/s1920/the-matrix-2-reloaded.jpg","https://images.justwatch.com/backdrop/300681582/s1920/the-matrix-2-reloaded.jpg","https://images.justwatch.com/backdrop/186039261/s1920/the-matrix-2-reloaded.jpg","https://images.justwatch.com/backdrop/8721517/s1920/the-matrix-2-reloaded.jpg","https://images.justwatch.com/backdrop/8721516/s1920/the-matrix-2-reloaded.jpg",],offers=[Offer(monetization_type="FLATRATE",presentation_type="HD",url="https://watch.amazon.com/detail?gti=amzn1.dv.gti.c19d194f-3fed-4960-ad7b-727e72672f33",price_string=None,price_value=None,price_currency="USD",name="Max Amazon Channel",technical_name="amazonhbomax",icon="https://images.justwatch.com/icon/305591736/s100/amazonhbomax.png",),Offer(monetization_type="FLATRATE",presentation_type="_4K",url="https://play.max.com/movie/15f1f852-5a97-4e78-b509-e045dbc1ba37",price_string=None,price_value=None,price_currency="USD",name="Max",technical_name="max",icon="https://images.justwatch.com/icon/305458112/s100/max.png",),Offer(monetization_type="RENT",presentation_type="_4K",url="https://tv.apple.com/us/movie/the-matrix-reloaded/umc.cmc.5b3qv27alugfj95rrag186slh?playableId=tvs.sbd.9001%3A283218560",price_string="$3.99",price_value=3.99,price_currency="USD",name="Apple TV",technical_name="itunes",icon="https://images.justwatch.com/icon/190848813/s100/itunes.png",),Offer(monetization_type="RENT",presentation_type="_4K",url="https://watch.amazon.com/detail?gti=amzn1.dv.gti.8ab2da9b-171c-3467-0647-402aac1572c3",price_string="$3.99",price_value=3.99,price_currency="USD",name="Amazon Video",technical_name="amazon",icon="https://images.justwatch.com/icon/430993/s100/amazon.png",),Offer(monetization_type="RENT",presentation_type="SD",url="https://play.google.com/store/movies/details/The_Matrix_Reloaded?gl=US&hl=en&id=uRVdSV8nBzw.P",price_string="$3.99",price_value=3.99,price_currency="USD",name="Google Play Movies",technical_name="play",icon="https://images.justwatch.com/icon/169478387/s100/play.png",),Offer(monetization_type="RENT",presentation_type="SD",url="https://www.youtube.com/results?search_query=The+Matrix+Reloaded%2Bmovie",price_string="$3.99",price_value=3.99,price_currency="USD",name="YouTube",technical_name="youtube",icon="https://images.justwatch.com/icon/59562423/s100/youtube.png",),Offer(monetization_type="RENT",presentation_type="_4K",url="https://www.vudu.com/content/movies/details/The-Matrix-Reloaded/10678",price_string="$3.99",price_value=3.99,price_currency="USD",name="Vudu",technical_name="vudu",icon="https://images.justwatch.com/icon/249324969/s100/vudu.png",),Offer(monetization_type="RENT",presentation_type="_4K",url="https://www.microsoft.com/en-us/p/the-matrix-reloaded/8d6kgwzl5hmr",price_string="$3.99",price_value=3.99,price_currency="USD",name="Microsoft Store",technical_name="microsoft",icon="https://images.justwatch.com/icon/820542/s100/microsoft.png",),Offer(monetization_type="RENT",presentation_type="_4K",url="https://www.directv.com/movies/The-Matrix-Reloaded-NXJOdzBaRTBoSFF0dWc5UU5Ramg5Zz09",price_string="$3.99",price_value=3.99,price_currency="USD",name="DIRECTV",technical_name="directv",icon="https://images.justwatch.com/icon/158260222/s100/directv.png",),Offer(monetization_type="RENT",presentation_type="HD",url="https://ondemand.spectrum.net/movies/31912/the-matrix-reloaded/",price_string="$3.99",price_value=3.99,price_currency="USD",name="Spectrum On Demand",technical_name="spectrumondemand",icon="https://images.justwatch.com/icon/305635208/s100/spectrumondemand.png",),Offer(monetization_type="BUY",presentation_type="HD",url="http://www.amctheatres.com/movies/the-matrix-reloaded-5505",price_string="$4.99",price_value=4.99,price_currency="USD",name="AMC on Demand",technical_name="amctheatresondemand",icon="https://images.justwatch.com/icon/166008757/s100/amctheatresondemand.png",),],),MediaEntry(entry_id="tm12",object_id=12,object_type="MOVIE",title="The Matrix Revolutions",url="https://justwatch.com/us/movie/the-matrix-revolutions",release_year=2003,release_date="2003-11-05",runtime_minutes=128,short_description="The human city of Zion defends itself against the massive invasion of the machines...",genres=["act","trl","scf"],imdb_id="tt0242653",poster="https://images.justwatch.com/poster/179166803/s718/the-matrix-revolutions.jpg",backdrops=["https://images.justwatch.com/backdrop/8721981/s1920/the-matrix-revolutions.jpg","https://images.justwatch.com/backdrop/8721983/s1920/the-matrix-revolutions.jpg","https://images.justwatch.com/backdrop/203549468/s1920/the-matrix-revolutions.jpg","https://images.justwatch.com/backdrop/8721987/s1920/the-matrix-revolutions.jpg","https://images.justwatch.com/backdrop/205405481/s1920/the-matrix-revolutions.jpg",],offers=[Offer(monetization_type="FLATRATE",presentation_type="HD",url="https://watch.amazon.com/detail?gti=amzn1.dv.gti.e390b59a-d138-45f8-9305-8806a4bcb984",price_string=None,price_value=None,price_currency="USD",name="Max Amazon Channel",technical_name="amazonhbomax",icon="https://images.justwatch.com/icon/305591736/s100/amazonhbomax.png",),Offer(monetization_type="FLATRATE",presentation_type="_4K",url="https://play.max.com/movie/7f34ec0d-34d9-42bb-96ac-251a42009f2d",price_string=None,price_value=None,price_currency="USD",name="Max",technical_name="max",icon="https://images.justwatch.com/icon/305458112/s100/max.png",),Offer(monetization_type="RENT",presentation_type="_4K",url="https://tv.apple.com/us/movie/the-matrix-revolutions/umc.cmc.52it1gdofstjm0glh3upzjjz5?playableId=tvs.sbd.9001%3A271469065",price_string="$3.99",price_value=3.99,price_currency="USD",name="Apple TV",technical_name="itunes",icon="https://images.justwatch.com/icon/190848813/s100/itunes.png",),Offer(monetization_type="RENT",presentation_type="_4K",url="https://watch.amazon.com/detail?gti=amzn1.dv.gti.e390b59a-d138-45f8-9305-8806a4bcb984",price_string="$3.99",price_value=3.99,price_currency="USD",name="Amazon Video",technical_name="amazon",icon="https://images.justwatch.com/icon/430993/s100/amazon.png",),Offer(monetization_type="RENT",presentation_type="SD",url="https://play.google.com/store/movies/details/The_Matrix_Revolutions?gl=US&hl=en&id=7AnXDfqMMHc.P",price_string="$3.99",price_value=3.99,price_currency="USD",name="Google Play Movies",technical_name="play",icon="https://images.justwatch.com/icon/169478387/s100/play.png",),Offer(monetization_type="RENT",presentation_type="SD",url="https://www.youtube.com/results?search_query=The+Matrix+Revolutions%2Bmovie",price_string="$3.99",price_value=3.99,price_currency="USD",name="YouTube",technical_name="youtube",icon="https://images.justwatch.com/icon/59562423/s100/youtube.png",),Offer(monetization_type="RENT",presentation_type="_4K",url="https://www.vudu.com/content/movies/details/The-Matrix-Revolutions/9986",price_string="$3.99",price_value=3.99,price_currency="USD",name="Vudu",technical_name="vudu",icon="https://images.justwatch.com/icon/249324969/s100/vudu.png",),Offer(monetization_type="RENT",presentation_type="_4K",url="https://www.microsoft.com/en-us/p/the-matrix-revolutions/8d6kgwzl6568",price_string="$3.99",price_value=3.99,price_currency="USD",name="Microsoft Store",technical_name="microsoft",icon="https://images.justwatch.com/icon/820542/s100/microsoft.png",),Offer(monetization_type="RENT",presentation_type="_4K",url="https://www.directv.com/movies/The-Matrix-Revolutions-R2ZTV0Z1dndSeU95SkdQODAwVWF4UT09",price_string="$3.99",price_value=3.99,price_currency="USD",name="DIRECTV",technical_name="directv",icon="https://images.justwatch.com/icon/158260222/s100/directv.png",),Offer(monetization_type="RENT",presentation_type="HD",url="https://ondemand.spectrum.net/movies/33157/the-matrix-revolutions/",price_string="$3.99",price_value=3.99,price_currency="USD",name="Spectrum On Demand",technical_name="spectrumondemand",icon="https://images.justwatch.com/icon/305635208/s100/spectrumondemand.png",),Offer(monetization_type="BUY",presentation_type="HD",url="http://www.amctheatres.com/movies/the-matrix-revolutions-5509",price_string="$14.99",price_value=14.99,price_currency="USD",name="AMC on Demand",technical_name="amctheatresondemand",icon="https://images.justwatch.com/icon/166008757/s100/amctheatresondemand.png",),],),]You can replace format in posters, backdrops and icons,.jpg,.png,.icoshould work.
You can also remove the extension altogether to get a default one - usually a JPEG.DisclaimerThis API is in no way affiliated, associated, authorized, endorsed by, or in any way officially connected with JustWatch.
This is an independent and unofficial project.
Use at your own risk.