Include titles without JW URL in search/popular

Add "'includeTitlesWithoutUrl': True" to search/popular filters.
This will include entries without dedicated JW page (and its URL).
Other data (like offers) seems OK.
"MediaEntry.url" marked as optional to accomodate.

Author: Electronic-Mango

src/simplejustwatchapi/query.py

@@ -85,7 +85,7 @@ def prepare_search_request(
             "searchTitlesFilter": {
                 "searchQuery": title,
                 "packages": providers,
-                **_list_variables(min_release_year, max_release_year, object_types),
+                **_filter_variables(min_release_year, max_release_year, object_types),
             },
             **_common_variables(best_only),
             **_locale_variables(country, language),
@@ -168,7 +168,7 @@ def prepare_popular_request(
             "first": count,
             "popularTitlesFilter": {
                 "packages": providers,
-                **_list_variables(min_release_year, max_release_year, object_types),
+                **_filter_variables(min_release_year, max_release_year, object_types),
             },
             **_common_variables(best_only),
             **_locale_variables(country, language),
@@ -528,13 +528,14 @@ def _locale_variables(country: str, language: str) -> dict[str, str]:
     return {"country": country.upper(), "language": language}
 
 
-def _list_variables(
+def _filter_variables(
     min_release_year: int | None,
     max_release_year: int | None,
     object_types: list[str] | str | None,
 ) -> dict[str, Any]:
     """Return dict with variables related to looking up lists of titles."""
     return {
+        "includeTitlesWithoutUrl": True,
         "objectTypes": object_types,
         "releaseYear": {"min": min_release_year, "max": max_release_year},
     }

src/simplejustwatchapi/tuples.py

@@ -222,7 +222,8 @@ class MediaEntry(NamedTuple):
         object_id (int): Object ID, the numeric part of full entry ID.
         object_type (str): Type of entry, e.g. `MOVIE`, `SHOW`.
         title (str): Full title.
-        url (str): URL to JustWatch with details for this entry.
+        url (str | None): URL to JustWatch with details for this entry. Some entries
+            are missing dedicated JustWatch pages, for them this field is `None`.
         release_year (int): Release year as a number.
         release_date (str): Full release date as a string, e.g. `2013-12-16`.
         runtime_minutes (int): Runtime in minutes.
@@ -255,7 +256,7 @@ class MediaEntry(NamedTuple):
     object_id: int
     object_type: str
     title: str
-    url: str
+    url: str | None
     release_year: int
     release_date: str
     runtime_minutes: int

test/simplejustwatchapi/test_request.py

@@ -39,8 +39,9 @@ def locale_variables(country, language):
     }
 
 
-def list_variables(min_release_year, max_release_year, object_types):
+def filter_variables(min_release_year, max_release_year, object_types):
     return {
+        "includeTitlesWithoutUrl": True,
         "objectTypes": object_types,
         "releaseYear": {"min": min_release_year, "max": max_release_year},
     }
@@ -109,7 +110,7 @@ def test_prepare_search_request(
             "searchTitlesFilter": {
                 "searchQuery": title,
                 "packages": providers,
-                **list_variables(min_release_year, max_release_year, object_types),
+                **filter_variables(min_release_year, max_release_year, object_types),
             },
             **common_variables(best_only),
             **locale_variables(country, language),
@@ -170,7 +171,7 @@ def test_prepare_popular_request(
             "first": count,
             "popularTitlesFilter": {
                 "packages": providers,
-                **list_variables(min_release_year, max_release_year, object_types),
+                **filter_variables(min_release_year, max_release_year, object_types),
             },
             **common_variables(best_only),
             **locale_variables(country, language),