Skip to content

Discover

Bases: TMDB

Discover functionality.

See: https://developers.themoviedb.org/3/discover

Source code in src/tmdb_client_py/discover.py 
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
class Discover(TMDB):
    """
    Discover functionality.

    See: https://developers.themoviedb.org/3/discover
    """

    BASE_PATH = "discover"
    URLS = {
        "movie": "/movie",
        "tv": "/tv",
    }

    def movie(self, **kwargs):
        """
        Discover movies by different types of data like average rating, number
        of votes, genres and certifications. You can get a valid list of
        certifications from the certifications list method.

        Discover also supports a nice list of sort options. See below for all
        of the available options.

        Please note, when using certification / certification.lte you must also
        specify certification_country. These two parameters work together in
        order to filter the results. You can only filter results with the
        countries we have added to our certifications list.

        If you specify the region parameter, the regional release date will be
        used instead of the primary release date. The date returned will be the
        first date based on your query (ie. if a with_release_type is
        specified). It's important to note the order of the release types that
        are used. Specifying "2|3" would return the limited theatrical release
        date as opposed to "3|2" which would return the theatrical date.

        Also note that a number of filters support being comma (,) or pipe (|)
        separated. Comma's are treated like an AND and query while pipe's are
        an OR.

        Some examples of what can be done with discover can be found at
        https://www.themoviedb.org/documentation/api/discover.

        Args:
            language: (optional) ISO 639-1 code.
            region: (optional) Specify a ISO 3166-1 code.
            sort_by: (optional) Allowed values: popularity.asc,
                popularity.desc, release_date.asc, release_date.desc,
                revenue.asc, revenue.desc, primary_release_date.asc,
                primary_release_date.desc, original_title.asc,
                original_title.desc, vote_average.asc, vote_average.desc,
                vote_count.asc, vote_count.desc
                Default: popularity.desc
            certification_country: (optional) Used in conjunction with the
                certification filter, use this to specify a country with a
                valid certification.
            certification: Filter results with a valid certification from the
                'certification_country' field.
            certification.gte: Filter and only include movies that have a
                certification that is greater than or equal to the specified
                value.
            certification.lte: Filter and only include movies that have a
                certification that is less than or equal to the specified
                value.
            include_adult: (optional) A filter and include or exclude adult
                movies.
            include_video: (optional) A filter to include or exclude videos.
            page: (optional) Minimum 1, maximum 1000, default 1.
            primary_release_year: (optional) A filter to limit the results to a
                specific primary release year.
            primary_release_date.gte: (optional) Filter and only include movies
                that have a primary release date that is greater or equal to
                the specified value.
            primary_release_date.lte: (optional) Filter and only include movies
                that have a primary release date that is less than or equal to
                the specified value.
            release_date.gte: (optional) Filter and only include movies that
                have a primary release date that is greater or equal to the
                specified value.
            releaste_date.lte: (optional) Filter and only include movies that
                have a primary release date that is less than or equal to the
                specified value.
            with_release_type: (optional) Specify a comma (AND) or pipe (OR)
                separated value to filter release types by. These release types
                map to the same values found on the movie release date method.
                Minimum 1, maximum 6.
            year: (optional) A filter to limit the results to a specific year
                (looking at all release dates).
            vote_count.gte: (optional) Filter and only include movies that have
                a vote count that is greater or equal to the specified value.
                Minimum 0.
            vote_count.lte: (optional) Filter and only include movies that have
                a vote count that is less than or equal to the specified value.
                Minimum 1.
            vote_average.gte: (optional) Filter and only include movies that
                have a rating that is greater or equal to the specified value.
                Minimum 0.
            vote_average.lte: (optional) Filter and only include movies that
                have a rating that is less than or equal to the specified value.
                Minimum 0.
            with_cast: (optional) A comma separated list of person ID's. Only
                include movies that have one of the ID's added as an actor.
            with_crew: (optional) A comma separated list of person ID's. Only
                include movies that have one of the ID's added as a crew member.
            with_people: (optional) A comma separated list of person ID's. Only
                include movies that have one of the ID's added as a either a
                actor or a crew member.
            with_companies: (optional) A comma separated list of production
                company ID's. Only include movies that have one of the ID's
                added as a production company.
            with_genres: (optional) Comma separated value of genre ids that you
                want to include in the results.
            without_genres: (optional) Comma separated value of genre ids that
                you want to exclude from the results.
            with_keywords: (optional) A comma separated list of keyword ID's.
                Only includes movies that have one of the ID's added as a
                keyword.
            without_keywords: (optional) Exclude items with certain keywords.
                You can comma and pipe separate these values to create an 'AND' or 'OR' logic.
            with_runtime.gte: (optional) Filter and only include movies that
                have a runtime that is greater or equal to a value.
            with_runtime.lte: (optional) Filter and only include movies that
                have a runtime that is less than or equal to a value.
            with_original_language: (optional) Specify an ISO 639-1 string to
                filter results by their original language value.

        Returns:
            A dict representation of the JSON returned from the API.
        """
        # Periods are not allowed in keyword arguments but several API
        # arguments contain periods. See both usages in tests/test_discover.py.
        for param in dict(kwargs):
            if "_lte" in param:
                kwargs[param.replace("_lte", ".lte")] = kwargs.pop(param)
            if "_gte" in param:
                kwargs[param.replace("_gte", ".gte")] = kwargs.pop(param)

        path = self._get_path("movie")

        response = self._GET(path, kwargs)
        self._set_attrs_to_values(response)
        return response

    def tv(self, **kwargs):
        """
        Discover TV shows by different types of data like average rating,
        number of votes, genres, the network they aired on and air dates.

        Discover also supports a nice list of sort options. See below for all
        of the available options.

        Also note that a number of filters support being comma (,) or pipe (|)
        separated. Comma's are treated like an AND and query while pipe's are
        an OR.

        Some examples of what can be done with discover can be found at
        https://www.themoviedb.org/documentation/api/discover.

        Args:
            language: (optional) ISO 639-1 code.
            sort_by: (optional) Available options are 'vote_average.desc',
                     'vote_average.asc', 'first_air_date.desc',
                     'first_air_date.asc', 'popularity.desc', 'popularity.asc'
            sort_by: (optional) Allowed values: vote_average.desc,
                vote_average.asc, first_air_date.desc, first_air_date.asc,
                popularity.desc, popularity.asc
                Default: popularity.desc
            air_date.gte: (optional) Filter and only include TV shows that have
                a air date (by looking at all episodes) that is greater or
                equal to the specified value.
            air_date.lte: (optional) Filter and only include TV shows that have
                a air date (by looking at all episodes) that is less than or
                equal to the specified value.
            first_air_date.gte: (optional) Filter and only include TV shows
                that have a original air date that is greater or equal to the
                specified value. Can be used in conjunction with the
                "include_null_first_air_dates" filter if you want to include
                items with no air date.
            first_air_date.lte: (optional) Filter and only include TV shows
                that have a original air date that is less than or equal to the
                specified value. Can be used in conjunction with the
                "include_null_first_air_dates" filter if you want to include
                items with no air date.
            first_air_date_year: (optional) Filter and only include TV shows
                that have a original air date year that equal to the specified
                value. Can be used in conjunction with the
                "include_null_first_air_dates" filter if you want to include
                items with no air date.
            page: (optional) Specify the page of results to query. Default 1.
            timezone: (optional) Used in conjunction with the air_date.gte/lte
                filter to calculate the proper UTC offset. Default
                America/New_York.
            vote_average.gte: (optional) Filter and only include movies that
                have a rating that is greater or equal to the specified value.
                Minimum 0.
            vote_count.gte: (optional) Filter and only include movies that have
                a rating that is less than or equal to the specified value.
                Minimum 0.
            with_genres: (optional) Comma separated value of genre ids that you
                want to include in the results.
            with_networks: (optional) Comma separated value of network ids that
                you want to include in the results.
            without_genres: (optional) Comma separated value of genre ids that
                you want to exclude from the results.
            with_runtime.gte: (optional) Filter and only include TV shows with
                an episode runtime that is greater than or equal to a value.
            with_runtime.lte: (optional) Filter and only include TV shows with
                an episode runtime that is less than or equal to a value.
            include_null_first_air_dates: (optional) Use this filter to include
                TV shows that don't have an air date while using any of the
                "first_air_date" filters.
            with_original_language: (optional) Specify an ISO 639-1 string to
                filter results by their original language value.
            without_keywords: (optional) Exclude items with certain keywords.
                You can comma and pipe separate these values to create an 'AND'
                or 'OR' logic.
            screened_theatrically: (optional) Filter results to include items
                that have been screened theatrically.
            with_companies: (optional) A comma separated list of production
                company ID's. Only include movies that have one of the ID's
                added as a production company.
            with_keywords: (optional) A comma separated list of keyword ID's.
                Only includes TV shows that have one of the ID's added as a
                keyword.

        Returns:
            A dict representation of the JSON returned from the API.
        """
        # Periods are not allowed in keyword arguments but several API
        # arguments contain periods. See both usages in tests/test_discover.py.
        for param in dict(kwargs):
            if "_lte" in param:
                kwargs[param.replace("_lte", ".lte")] = kwargs.pop(param)
            if "_gte" in param:
                kwargs[param.replace("_gte", ".gte")] = kwargs.pop(param)

        path = self._get_path("tv")

        response = self._GET(path, kwargs)
        self._set_attrs_to_values(response)
        return response

movie(**kwargs)

Discover movies by different types of data like average rating, number of votes, genres and certifications. You can get a valid list of certifications from the certifications list method.

Discover also supports a nice list of sort options. See below for all of the available options.

Please note, when using certification / certification.lte you must also specify certification_country. These two parameters work together in order to filter the results. You can only filter results with the countries we have added to our certifications list.

If you specify the region parameter, the regional release date will be used instead of the primary release date. The date returned will be the first date based on your query (ie. if a with_release_type is specified). It's important to note the order of the release types that are used. Specifying "2|3" would return the limited theatrical release date as opposed to "3|2" which would return the theatrical date.

Also note that a number of filters support being comma (,) or pipe (|) separated. Comma's are treated like an AND and query while pipe's are an OR.

Some examples of what can be done with discover can be found at https://www.themoviedb.org/documentation/api/discover.

Parameters:

Name Type Description Default
language

(optional) ISO 639-1 code.

 required
region

(optional) Specify a ISO 3166-1 code.

 required
sort_by

(optional) Allowed values: popularity.asc, popularity.desc, release_date.asc, release_date.desc, revenue.asc, revenue.desc, primary_release_date.asc, primary_release_date.desc, original_title.asc, original_title.desc, vote_average.asc, vote_average.desc, vote_count.asc, vote_count.desc Default: popularity.desc

 required
certification_country

(optional) Used in conjunction with the certification filter, use this to specify a country with a valid certification.

 required
certification

Filter results with a valid certification from the 'certification_country' field.

 required
certification.gte

Filter and only include movies that have a certification that is greater than or equal to the specified value.

 required
certification.lte

Filter and only include movies that have a certification that is less than or equal to the specified value.

 required
include_adult

(optional) A filter and include or exclude adult movies.

 required
include_video

(optional) A filter to include or exclude videos.

 required
page

(optional) Minimum 1, maximum 1000, default 1.

 required
primary_release_year

(optional) A filter to limit the results to a specific primary release year.

 required
primary_release_date.gte

(optional) Filter and only include movies that have a primary release date that is greater or equal to the specified value.

 required
primary_release_date.lte

(optional) Filter and only include movies that have a primary release date that is less than or equal to the specified value.

 required
release_date.gte

(optional) Filter and only include movies that have a primary release date that is greater or equal to the specified value.

 required
releaste_date.lte

(optional) Filter and only include movies that have a primary release date that is less than or equal to the specified value.

 required
with_release_type

(optional) Specify a comma (AND) or pipe (OR) separated value to filter release types by. These release types map to the same values found on the movie release date method. Minimum 1, maximum 6.

 required
year

(optional) A filter to limit the results to a specific year (looking at all release dates).

 required
vote_count.gte

(optional) Filter and only include movies that have a vote count that is greater or equal to the specified value. Minimum 0.

 required
vote_count.lte

(optional) Filter and only include movies that have a vote count that is less than or equal to the specified value. Minimum 1.

 required
vote_average.gte

(optional) Filter and only include movies that have a rating that is greater or equal to the specified value. Minimum 0.

 required
vote_average.lte

(optional) Filter and only include movies that have a rating that is less than or equal to the specified value. Minimum 0.

 required
with_cast

(optional) A comma separated list of person ID's. Only include movies that have one of the ID's added as an actor.

 required
with_crew

(optional) A comma separated list of person ID's. Only include movies that have one of the ID's added as a crew member.

 required
with_people

(optional) A comma separated list of person ID's. Only include movies that have one of the ID's added as a either a actor or a crew member.

 required
with_companies

(optional) A comma separated list of production company ID's. Only include movies that have one of the ID's added as a production company.

 required
with_genres

(optional) Comma separated value of genre ids that you want to include in the results.

 required
without_genres

(optional) Comma separated value of genre ids that you want to exclude from the results.

 required
with_keywords

(optional) A comma separated list of keyword ID's. Only includes movies that have one of the ID's added as a keyword.

 required
without_keywords

(optional) Exclude items with certain keywords. You can comma and pipe separate these values to create an 'AND' or 'OR' logic.

 required
with_runtime.gte

(optional) Filter and only include movies that have a runtime that is greater or equal to a value.

 required
with_runtime.lte

(optional) Filter and only include movies that have a runtime that is less than or equal to a value.

 required
with_original_language

(optional) Specify an ISO 639-1 string to filter results by their original language value.

 required

Returns:

Type Description

A dict representation of the JSON returned from the API.
Source code in src/tmdb_client_py/discover.py 
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
def movie(self, **kwargs):
    """
    Discover movies by different types of data like average rating, number
    of votes, genres and certifications. You can get a valid list of
    certifications from the certifications list method.

    Discover also supports a nice list of sort options. See below for all
    of the available options.

    Please note, when using certification / certification.lte you must also
    specify certification_country. These two parameters work together in
    order to filter the results. You can only filter results with the
    countries we have added to our certifications list.

    If you specify the region parameter, the regional release date will be
    used instead of the primary release date. The date returned will be the
    first date based on your query (ie. if a with_release_type is
    specified). It's important to note the order of the release types that
    are used. Specifying "2|3" would return the limited theatrical release
    date as opposed to "3|2" which would return the theatrical date.

    Also note that a number of filters support being comma (,) or pipe (|)
    separated. Comma's are treated like an AND and query while pipe's are
    an OR.

    Some examples of what can be done with discover can be found at
    https://www.themoviedb.org/documentation/api/discover.

    Args:
        language: (optional) ISO 639-1 code.
        region: (optional) Specify a ISO 3166-1 code.
        sort_by: (optional) Allowed values: popularity.asc,
            popularity.desc, release_date.asc, release_date.desc,
            revenue.asc, revenue.desc, primary_release_date.asc,
            primary_release_date.desc, original_title.asc,
            original_title.desc, vote_average.asc, vote_average.desc,
            vote_count.asc, vote_count.desc
            Default: popularity.desc
        certification_country: (optional) Used in conjunction with the
            certification filter, use this to specify a country with a
            valid certification.
        certification: Filter results with a valid certification from the
            'certification_country' field.
        certification.gte: Filter and only include movies that have a
            certification that is greater than or equal to the specified
            value.
        certification.lte: Filter and only include movies that have a
            certification that is less than or equal to the specified
            value.
        include_adult: (optional) A filter and include or exclude adult
            movies.
        include_video: (optional) A filter to include or exclude videos.
        page: (optional) Minimum 1, maximum 1000, default 1.
        primary_release_year: (optional) A filter to limit the results to a
            specific primary release year.
        primary_release_date.gte: (optional) Filter and only include movies
            that have a primary release date that is greater or equal to
            the specified value.
        primary_release_date.lte: (optional) Filter and only include movies
            that have a primary release date that is less than or equal to
            the specified value.
        release_date.gte: (optional) Filter and only include movies that
            have a primary release date that is greater or equal to the
            specified value.
        releaste_date.lte: (optional) Filter and only include movies that
            have a primary release date that is less than or equal to the
            specified value.
        with_release_type: (optional) Specify a comma (AND) or pipe (OR)
            separated value to filter release types by. These release types
            map to the same values found on the movie release date method.
            Minimum 1, maximum 6.
        year: (optional) A filter to limit the results to a specific year
            (looking at all release dates).
        vote_count.gte: (optional) Filter and only include movies that have
            a vote count that is greater or equal to the specified value.
            Minimum 0.
        vote_count.lte: (optional) Filter and only include movies that have
            a vote count that is less than or equal to the specified value.
            Minimum 1.
        vote_average.gte: (optional) Filter and only include movies that
            have a rating that is greater or equal to the specified value.
            Minimum 0.
        vote_average.lte: (optional) Filter and only include movies that
            have a rating that is less than or equal to the specified value.
            Minimum 0.
        with_cast: (optional) A comma separated list of person ID's. Only
            include movies that have one of the ID's added as an actor.
        with_crew: (optional) A comma separated list of person ID's. Only
            include movies that have one of the ID's added as a crew member.
        with_people: (optional) A comma separated list of person ID's. Only
            include movies that have one of the ID's added as a either a
            actor or a crew member.
        with_companies: (optional) A comma separated list of production
            company ID's. Only include movies that have one of the ID's
            added as a production company.
        with_genres: (optional) Comma separated value of genre ids that you
            want to include in the results.
        without_genres: (optional) Comma separated value of genre ids that
            you want to exclude from the results.
        with_keywords: (optional) A comma separated list of keyword ID's.
            Only includes movies that have one of the ID's added as a
            keyword.
        without_keywords: (optional) Exclude items with certain keywords.
            You can comma and pipe separate these values to create an 'AND' or 'OR' logic.
        with_runtime.gte: (optional) Filter and only include movies that
            have a runtime that is greater or equal to a value.
        with_runtime.lte: (optional) Filter and only include movies that
            have a runtime that is less than or equal to a value.
        with_original_language: (optional) Specify an ISO 639-1 string to
            filter results by their original language value.

    Returns:
        A dict representation of the JSON returned from the API.
    """
    # Periods are not allowed in keyword arguments but several API
    # arguments contain periods. See both usages in tests/test_discover.py.
    for param in dict(kwargs):
        if "_lte" in param:
            kwargs[param.replace("_lte", ".lte")] = kwargs.pop(param)
        if "_gte" in param:
            kwargs[param.replace("_gte", ".gte")] = kwargs.pop(param)

    path = self._get_path("movie")

    response = self._GET(path, kwargs)
    self._set_attrs_to_values(response)
    return response

tv(**kwargs)

Discover TV shows by different types of data like average rating, number of votes, genres, the network they aired on and air dates.

Discover also supports a nice list of sort options. See below for all of the available options.

Also note that a number of filters support being comma (,) or pipe (|) separated. Comma's are treated like an AND and query while pipe's are an OR.

Some examples of what can be done with discover can be found at https://www.themoviedb.org/documentation/api/discover.

Parameters:

Name Type Description Default
language

(optional) ISO 639-1 code.

 required
sort_by

(optional) Available options are 'vote_average.desc', 'vote_average.asc', 'first_air_date.desc', 'first_air_date.asc', 'popularity.desc', 'popularity.asc'

 required
sort_by

(optional) Allowed values: vote_average.desc, vote_average.asc, first_air_date.desc, first_air_date.asc, popularity.desc, popularity.asc Default: popularity.desc

 required
air_date.gte

(optional) Filter and only include TV shows that have a air date (by looking at all episodes) that is greater or equal to the specified value.

 required
air_date.lte

(optional) Filter and only include TV shows that have a air date (by looking at all episodes) that is less than or equal to the specified value.

 required
first_air_date.gte

(optional) Filter and only include TV shows that have a original air date that is greater or equal to the specified value. Can be used in conjunction with the "include_null_first_air_dates" filter if you want to include items with no air date.

 required
first_air_date.lte

(optional) Filter and only include TV shows that have a original air date that is less than or equal to the specified value. Can be used in conjunction with the "include_null_first_air_dates" filter if you want to include items with no air date.

 required
first_air_date_year

(optional) Filter and only include TV shows that have a original air date year that equal to the specified value. Can be used in conjunction with the "include_null_first_air_dates" filter if you want to include items with no air date.

 required
page

(optional) Specify the page of results to query. Default 1.

 required
timezone

(optional) Used in conjunction with the air_date.gte/lte filter to calculate the proper UTC offset. Default America/New_York.

 required
vote_average.gte

(optional) Filter and only include movies that have a rating that is greater or equal to the specified value. Minimum 0.

 required
vote_count.gte

(optional) Filter and only include movies that have a rating that is less than or equal to the specified value. Minimum 0.

 required
with_genres

(optional) Comma separated value of genre ids that you want to include in the results.

 required
with_networks

(optional) Comma separated value of network ids that you want to include in the results.

 required
without_genres

(optional) Comma separated value of genre ids that you want to exclude from the results.

 required
with_runtime.gte

(optional) Filter and only include TV shows with an episode runtime that is greater than or equal to a value.

 required
with_runtime.lte

(optional) Filter and only include TV shows with an episode runtime that is less than or equal to a value.

 required
include_null_first_air_dates

(optional) Use this filter to include TV shows that don't have an air date while using any of the "first_air_date" filters.

 required
with_original_language

(optional) Specify an ISO 639-1 string to filter results by their original language value.

 required
without_keywords

(optional) Exclude items with certain keywords. You can comma and pipe separate these values to create an 'AND' or 'OR' logic.

 required
screened_theatrically

(optional) Filter results to include items that have been screened theatrically.

 required
with_companies

(optional) A comma separated list of production company ID's. Only include movies that have one of the ID's added as a production company.

 required
with_keywords

(optional) A comma separated list of keyword ID's. Only includes TV shows that have one of the ID's added as a keyword.

 required

Returns:

Type Description

A dict representation of the JSON returned from the API.
Source code in src/tmdb_client_py/discover.py 
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
def tv(self, **kwargs):
    """
    Discover TV shows by different types of data like average rating,
    number of votes, genres, the network they aired on and air dates.

    Discover also supports a nice list of sort options. See below for all
    of the available options.

    Also note that a number of filters support being comma (,) or pipe (|)
    separated. Comma's are treated like an AND and query while pipe's are
    an OR.

    Some examples of what can be done with discover can be found at
    https://www.themoviedb.org/documentation/api/discover.

    Args:
        language: (optional) ISO 639-1 code.
        sort_by: (optional) Available options are 'vote_average.desc',
                 'vote_average.asc', 'first_air_date.desc',
                 'first_air_date.asc', 'popularity.desc', 'popularity.asc'
        sort_by: (optional) Allowed values: vote_average.desc,
            vote_average.asc, first_air_date.desc, first_air_date.asc,
            popularity.desc, popularity.asc
            Default: popularity.desc
        air_date.gte: (optional) Filter and only include TV shows that have
            a air date (by looking at all episodes) that is greater or
            equal to the specified value.
        air_date.lte: (optional) Filter and only include TV shows that have
            a air date (by looking at all episodes) that is less than or
            equal to the specified value.
        first_air_date.gte: (optional) Filter and only include TV shows
            that have a original air date that is greater or equal to the
            specified value. Can be used in conjunction with the
            "include_null_first_air_dates" filter if you want to include
            items with no air date.
        first_air_date.lte: (optional) Filter and only include TV shows
            that have a original air date that is less than or equal to the
            specified value. Can be used in conjunction with the
            "include_null_first_air_dates" filter if you want to include
            items with no air date.
        first_air_date_year: (optional) Filter and only include TV shows
            that have a original air date year that equal to the specified
            value. Can be used in conjunction with the
            "include_null_first_air_dates" filter if you want to include
            items with no air date.
        page: (optional) Specify the page of results to query. Default 1.
        timezone: (optional) Used in conjunction with the air_date.gte/lte
            filter to calculate the proper UTC offset. Default
            America/New_York.
        vote_average.gte: (optional) Filter and only include movies that
            have a rating that is greater or equal to the specified value.
            Minimum 0.
        vote_count.gte: (optional) Filter and only include movies that have
            a rating that is less than or equal to the specified value.
            Minimum 0.
        with_genres: (optional) Comma separated value of genre ids that you
            want to include in the results.
        with_networks: (optional) Comma separated value of network ids that
            you want to include in the results.
        without_genres: (optional) Comma separated value of genre ids that
            you want to exclude from the results.
        with_runtime.gte: (optional) Filter and only include TV shows with
            an episode runtime that is greater than or equal to a value.
        with_runtime.lte: (optional) Filter and only include TV shows with
            an episode runtime that is less than or equal to a value.
        include_null_first_air_dates: (optional) Use this filter to include
            TV shows that don't have an air date while using any of the
            "first_air_date" filters.
        with_original_language: (optional) Specify an ISO 639-1 string to
            filter results by their original language value.
        without_keywords: (optional) Exclude items with certain keywords.
            You can comma and pipe separate these values to create an 'AND'
            or 'OR' logic.
        screened_theatrically: (optional) Filter results to include items
            that have been screened theatrically.
        with_companies: (optional) A comma separated list of production
            company ID's. Only include movies that have one of the ID's
            added as a production company.
        with_keywords: (optional) A comma separated list of keyword ID's.
            Only includes TV shows that have one of the ID's added as a
            keyword.

    Returns:
        A dict representation of the JSON returned from the API.
    """
    # Periods are not allowed in keyword arguments but several API
    # arguments contain periods. See both usages in tests/test_discover.py.
    for param in dict(kwargs):
        if "_lte" in param:
            kwargs[param.replace("_lte", ".lte")] = kwargs.pop(param)
        if "_gte" in param:
            kwargs[param.replace("_gte", ".gte")] = kwargs.pop(param)

    path = self._get_path("tv")

    response = self._GET(path, kwargs)
    self._set_attrs_to_values(response)
    return response