Skip to main content

Simple JustWatch Python API

PyPi License Python versions CodeQL Ruff Pytest Coverage Status

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/.

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.

Metadata

Release files for simple-justwatch-python-api 1.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for simple-justwatch-python-api 1.4.0
File Size Uploaded
simple_justwatch_python_api-1.4.0.tar.gz 16.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for simple-justwatch-python-api 1.4.0
File Interpreter ABI Platform
simple_justwatch_python_api-1.4.0-py3-none-any.whl Python 3 none any Details

Total release size: 36.4 kB

Release files / simple_justwatch_python_api-1.4.0.tar.gz

Download URL simple_justwatch_python_api-1.4.0.tar.gz
Size 16.6 kB
Tags Source
SHA-256 checksum
How to use checksums
e30008393b09e6d69fc60502f827eacd0fa3033d68fc715a1e3709c1204f1518
BLAKE2b-256 checksum
How to use checksums
e138cf0910f2306d465fbb6e50fa2f39e3569faf0b11d09f4f03fc391e52698e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"CachyOS Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / simple_justwatch_python_api-1.4.0-py3-none-any.whl

Download URL simple_justwatch_python_api-1.4.0-py3-none-any.whl
Size 19.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
aabcdc03cb31d1803d3baaa6f0ceba33064616e61ba166a4cbc31bf1196ff1e2
BLAKE2b-256 checksum
How to use checksums
e925fa7ecbc3c79c3ba9a40b9e62ed9a0d12d7c3a0d20bf6290cf7f242585abd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"CachyOS Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

1.4.0 This release

2 release files

1.3.1

2 release files

1.3.0

2 release files

1.2.0

2 release files

1.1.0

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.17.1

1 release file

0.17

2 release files

0.16

2 release files

0.15

2 release files

0.14

2 release files

0.13

1 release file

0.12

1 release file

0.11

1 release file

0.10

1 release file

0.9

1 release file

0.8

1 release file

0.7

1 release file

0.6

1 release file

0.5

1 release file

0.4

1 release file

0.3

1 release file

0.2

1 release file

0.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page