Update README.me

Add information about new functions.
Add section on request complexity.
Describe type-specific fields in "MediaEntry".

Author: Electronic-Mango

README.md

@@ -81,6 +81,8 @@ If a platform offers streaming for a given entry in 4K, HD and SD, then `best_on
 
 Returned value is a list of [`MediaEntry`](#return-data-structures) objects.
 
+For very large searches (high `count` value) I recommend using default `best_only=True` to avoid issues with [request complexity](#request-complexity).
+
 Example command and its output is in [`examples/search_output.py`](examples/search_output.py).
 
 
@@ -111,9 +113,72 @@ General usage of these arguments matches the [`search`](#search) command.
 
 Returned value is a single [`MediaEntry`](#return-data-structures) object.
 
+This function can be used for all types of media - shows, movies, episodes, seasons (the last two having their dedicated functions described below),
+for all types the result is a single [`MediaEntry`](#return-data-structures) object.
+Some fields are specific for one of the media types and will be `None` for others - e.g.:
+ - `total_episode_count` is only present for seasons
+ - `season_number` is present for seasons and episodes
+ - `episode_number` is present only for episodes
+ - `age_certification` is present only for movies and shows
+
+For episodes specifically most of the fields will be empty (which is why [`episodes`](#episodes) command returns different structure).
+
 Example command and its output is in [`examples/details_output.py`](examples/details_output.py).
 
 
+### Seasons
+
+Seasons function allows for looking up all seasons of a show via its node ID.
+Node/show ID can be taken from output of the [`search`](#search) command.
+It's also the same ID as input for [`details`](#details) command.
+
+Each season contains similar data to the [`details`](#details) command, with additional season number and number of episodes.
+
+Usage also matches [`details`](#details) command:
+```python
+from simplejustwatchapi.justwatch import seasons
+
+results = seasons("nodeID", "US", "en", False)
+```
+
+Only the first argument is required - the node ID of element to look up details for.
+
+|   | Argument    | Type   | Required | Default value | Description                                            |
+|---|-------------|--------|----------|---------------|--------------------------------------------------------|
+| 1 | `show_id`   | `str`  | **YES**  | -             | Node/show ID to look up                                |
+| 2 | `country`   | `str`  | NO       | `"US"`        | Country to search for offers                           |
+| 3 | `language`  | `str`  | NO       | `"en"`        | Language of responses                                  |
+| 5 | `best_only` | `bool` | NO       | `True`        | Determines whether only best offers should be returned |
+
+Returned value is a list of [`MediaEntry`](#return-data-structures) objects, each describing a single season.
+
+
+### Episodes
+
+Episodes function allows for looking up all episodes of a season via season's node ID.
+Node/season ID can be taken from output of the [`seasons`](#seasons) command.
+
+Usage matches [`details`](#details) command:
+```python
+from simplejustwatchapi.justwatch import seasons
+
+results = seasons("nodeID", "US", "en", False)
+```
+
+Only the first argument is required - the node ID of element to look up details for.
+
+|   | Argument    | Type   | Required | Default value | Description                                            |
+|---|-------------|--------|----------|---------------|--------------------------------------------------------|
+| 1 | `season_id` | `str`  | **YES**  | -             | Node/season ID to look up                              |
+| 2 | `country`   | `str`  | NO       | `"US"`        | Country to search for offers                           |
+| 3 | `language`  | `str`  | NO       | `"en"`        | Language of responses                                  |
+| 5 | `best_only` | `bool` | NO       | `True`        | Determines whether only best offers should be returned |
+
+Returned value is a list of [`Episode`](#return-data-structures) objects, each describing a single episode.
+Each contains only a small subset of fields from the [`MediaEntry`](#return-data-structures) object,
+JustWatch API doesn't return "full" data.
+
+
 ### Offers for countries
 
 This function allows looking up offers for entry by given node ID.
@@ -147,6 +212,17 @@ Example command and its output is in [`examples/offers_for_countries_output.py`]
 
 Detailed descriptions of all used data structures are available in the [documentation](https://electronic-mango.github.io/simple-justwatch-python-api/simplejustwatchapi.html#module-simplejustwatchapi.query).
 
+The main structure `MediaEntry` contains fields for all media types - movies, shows, seasons, episodes.
+Some fields are specific for one of the media types and will be `None` for others - e.g.:
+ - `total_episode_count` is only present for seasons
+ - `season_number` is present for seasons and episodes
+ - `episode_number` is present only for episodes
+ - `age_certification` is present only for movies and shows
+
+For episodes specifically most of the fields will be empty (which is why [`episodes`](#episodes) command returns different structure).
+
+As [`search`](#search) function can return only movies and shows the episode-specific and season-specific fields will always be `None`,
+but are included in `MediaEntry` so they will be present in output from [`details`](#details) function.
 
 
 ## Locale, language, country
@@ -165,6 +241,20 @@ If you provide unsupported language JustWatch API should default to english.
 
 
 
+## Request complexity
+
+JustWatch API will respond with error on too high request/response complexity - essentially when returned graph would be too large.
+It's the reason for why seasons/episodes data isn't available directly in [`search`](#search), or [`details`](#details) function
+(mostly the former).
+
+This issue can still occur for [`search`](#search) with too high `count` value.
+In my tests the limit is around 100 (in the worst case with `best_only=False`).
+It's a lot, but keep it in mind.
+
+Using `best_only=True` should alleviate the issue somewhat, so for very large requests I recommend using its default `True` value.
+
+
+
 ## Disclaimer
 
 This API is in no way affiliated, associated, authorized, endorsed by, or in any way officially connected with JustWatch.