You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
-[Maximum number of entries](#maximum-number-of-entries)
32
32
-[Provider codes](#provider-codes)
33
33
-[`providers` function](#providers-function)
@@ -102,7 +102,7 @@ If JustWatch GraphQL API returns fewer entries, then this function will also ret
102
102
`best_only` determines whether similar offers, but lower quality should be included in response.
103
103
If a platform offers streaming for a given entry in 4K, HD and SD, then `best_only = True` will return only the 4K offer, `best_only = False` will return all three.
104
104
105
-
`offset` allows for very basic pagination, letting you get more data without running into [request complexity](#request-complexity).
105
+
`offset` allows for very basic pagination, letting you get more data without running into [operation complexity](#operation-complexity).
106
106
It simply skips `offset` number of first entries (on the API side, nothing is done inside the library).
107
107
Since there is no session there's no guarantee of results "stability" - if JustWatch decides to
108
108
shuffle returned values (I'm not sure what would be the reason, but in theory it's possible)
@@ -117,7 +117,7 @@ or check [Provider codes](#provider-codes) for more details.
117
117
118
118
Returned value is a list of [`MediaEntry`](#return-data-structures) objects.
119
119
120
-
For very large searches (high `count` value) I recommend using default `best_only=True` to avoid issues with [request complexity](#request-complexity).
120
+
For very large searches (high `count` value) I recommend using default `best_only=True` to avoid issues with [operation complexity](#operation-complexity).
121
121
122
122
Example function call and its output is in [`examples/search_output.py`](examples/search_output.py).
123
123
@@ -154,7 +154,7 @@ If JustWatch GraphQL API returns fewer entries, then this function will also ret
154
154
`best_only` determines whether similar offers, but lower quality should be included in response.
155
155
If a platform offers streaming for a given entry in 4K, HD and SD, then `best_only = True` will return only the 4K offer, `best_only = False` will return all three.
156
156
157
-
`offset` allows for very basic pagination letting you get more data without running into [request complexity](#request-complexity).
157
+
`offset` allows for very basic pagination letting you get more data without running into [operation complexity](#operation-complexity).
158
158
It simply skips first entries (on the API side, nothing is done inside the library).
159
159
Since there is no session there's no guarantee of results "stability" - if JustWatch decides to
160
160
shuffle returned values (I'm not sure what would be the reason, but in theory it's possible)
@@ -169,7 +169,7 @@ or check [Provider codes](#provider-codes) for more details.
169
169
170
170
Returned value is a list of [`MediaEntry`](#return-data-structures) objects.
171
171
172
-
For very large searches (high `count` value) I recommend using default `best_only=True` to avoid issues with [request complexity](#request-complexity).
172
+
For very large searches (high `count` value) I recommend using default `best_only=True` to avoid issues with [operation complexity](#operation-complexity).
173
173
174
174
Example function call and its output is in [`examples/popular_output.py`](examples/popular_output.py).
175
175
@@ -357,9 +357,9 @@ Any combination of those languages and countries should work with this API as we
357
357
358
358
359
359
360
-
## Request complexity
360
+
## Operation complexity
361
361
362
-
JustWatch API will respond with error on too high request/response complexity - essentially when returned graph would be too large.
362
+
JustWatch API will respond with error on too high operation complexity - essentially when returned graph would be too large.
363
363
It's the reason for why seasons/episodes data isn't available directly in [`search`](#search), or [`details`](#details) function
364
364
(mostly the former).
365
365
@@ -373,7 +373,7 @@ Using `best_only=True` should alleviate the issue somewhat, so for very large re
373
373
374
374
## Maximum number of entries
375
375
376
-
The JustWatch API itself won't allow for getting more than 1999 entries, through `count` and `offset`, regardless of request complexity.
376
+
The JustWatch API itself won't allow for getting more than 1999 entries, through `count` and `offset`, regardless of operation complexity.
377
377
If you try to get the 2000th entry the API (and functions in this libary) will return an empty list.
378
378
379
379
**If you try to access over the 1999th entry you won't get *up to* 1999 entries, you'll get an empty list.**
0 commit comments