Skip to main content
GET
TV

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

air_date.gte
string<date>

Filters results to include only those with an air date on or after the specified date (YYYY-MM-DD).

air_date.lte
string<date>

Filters results to include only those with an air date on or before the specified date (YYYY-MM-DD).

first_air_date_year
integer

Filters results to include only those with a first air date matching the specified year (YYYY).

first_air_date.gte
string<date>

Filters results to include only those with a first air date on or after the specified date (YYYY-MM-DD).

first_air_date.lte
string<date>

Filters results to include only those with a first air date on or before the specified date (YYYY-MM-DD).

include_adult
boolean

Whether to include adult content (true) or exclude it (false).

Example:

false

include_null_first_air_dates
boolean

Whether to include TV shows with missing first air dates.

Example:

false

language
string
default:en-US

The language of the results, formatted as an ISO 639-1 code (e.g., en-US).

page
integer
default:1

The page number of results to retrieve (for pagination).

screened_theatrically
boolean

Whether the movie was screened theatrically.

sort_by
enum<string>

Sorting criteria for results (e.g., popularity, vote count, first air date).

Available options:
first_air_date.asc,
first_air_date.desc,
name.asc,
name.desc,
original_name.asc,
original_name.desc,
popularity.asc,
popularity.desc,
vote_average.asc,
vote_average.desc,
vote_count.asc,
vote_count.desc
timezone
string

The timezone for date-related queries (e.g., America/New_York).

vote_average.gte
number<float>

Minimum vote average for filtering results.

vote_average.lte
number<float>

Maximum vote average for filtering results.

vote_count.gte
number<float>

Minimum number of votes a movie or show must have to be included in the results.

vote_count.lte
number<float>

Maximum number of votes a movie or show can have to be included in the results.

watch_region
string

The country code (ISO 3166-1) to filter available streaming content.

with_companies
string

Filter by production companies (comma , for AND, pipe | for OR).

with_genres
string

Filter by genre IDs (comma , for AND, pipe | for OR).

with_keywords
string

Filter by keywords (comma , for AND, pipe | for OR).

with_networks
integer

Filter by network ID (e.g., Netflix, HBO).

with_origin_country
string

Filter by the original country of production (ISO 3166-1 code).

with_original_language
string

Filter by the original language of the content (ISO 639-1 code).

with_runtime.gte
integer

Minimum runtime (in minutes) for filtering results.

with_runtime.lte
integer

Maximum runtime (in minutes) for filtering results.

with_status
string

Filter by status (possible values- 0, 1, 2, 3, 4, 5) using comma , (AND) or pipe | (OR).

with_watch_monetization
string

Filter by monetization type (possible values- flatrate, free, ads, rent, buy). Use in conjunction with watch_region.

with_watch_providers
string

Filter by streaming providers. Use with watch_region.

without_companies
string

Exclude content from specific production companies.

without_genres
string

Exclude content with specific genre IDs.

without_keywords
string

Exclude content with specific keywords.

without_watch_providers
string

Exclude content from specific streaming providers.

with_type
string

Filter by type (possible values- 0, 1, 2, 3, 4, 5) using comma , (AND) or pipe | (OR).

Response

200 - application/json

TV

page
number
Example:

1

results
object[]
Example:
total_pages
number
Example:

9456

total_results
number
Example:

189114