simple-justwatch-python-api 1.0.0

A simple JustWatch Python API

Simple JustWatch Python API

A simple unofficial JustWatch Python API which uses GraphQL to access JustWatch data, available for Python 3.11+.

This project is managed by uv.

Installation

This library is available through PyPi:

pip install simple-justwatch-python-api

Documentation

Detailed documentation is available at: https://electronic-mango.github.io/simple-justwatch-python-api/.

Highlights

This Python library has multiple functions:

• search - search for entries based on title
• popular - get a list of currently popular titles
• details - get details for entry based on its node ID
• seasons - get information about all seasons of a show
• episodes - get information about all episodes of a season
• offers_for_countries - get offers for entry based on its node ID, can look for offers in multiple countries
• providers - get data about available providers (e.g., Netflix)

Example outputs from all functions are in examples/ directory.

Quick example

from simplejustwatchapi import search

results = search("The Matrix", country="US", language="en", count=3)

for entry in results:
    print(entry.title, entry.object_type, len(entry.offers))

License

This library is licensed under MIT license (LICENSE or https://opensource.org/license/MIT)

Disclaimer

This library 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.