> ## Documentation Index
> Fetch the complete documentation index at: https://biscon.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# TV

> This endpoint find movies using over 30 filters and sort options.




## OpenAPI

````yaml get /discover/tv
openapi: 3.0.3
info:
  title: TMDB API DOCUMENTATION
  description: >-
    The Movie Database is an API that provides comprehensive movie, TV show, and
    celebrity data. TMDB offers APIs that developers use to access and integrate
    its data into applications, websites, or services.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.themoviedb.org/3
security:
  - bearerAuth: []
tags:
  - name: Authentication
    description: Endpoints for managing authentication, including login and user sessions.
  - name: Account
    description: Endpoints for managing user accounts, such as profiles and settings.
  - name: Certification
    description: Endpoints for retrieving and managing certification data.
  - name: Changes
    description: Endpoints for tracking changes and updates across the system.
  - name: Collection
    description: Endpoints for managing and accessing user collections.
  - name: Companies
    description: Endpoints for retrieving and managing company-related data.
  - name: Configuration
    description: Endpoints for accessing and updating system configuration settings.
  - name: Credits
    description: Endpoints for retrieving credit information related to movies or shows.
  - name: Discover
    description: Endpoints for discovering content based on filters and criteria.
  - name: Find
    description: Endpoints for locating specific items or entities in the database.
  - name: Genres
    description: Endpoints for retrieving and managing genres for categorization.
  - name: Guest Sessions
    description: Endpoints for creating and managing guest user sessions.
  - name: Keywords
    description: Endpoints for managing and searching content using keywords.
  - name: Lists
    description: Endpoints for creating and managing user-generated lists.
  - name: Movie Lists
    description: Endpoints for retrieving and managing lists of movies.
  - name: Movies
    description: Endpoints for retrieving detailed information about movies.
  - name: Networks
    description: Endpoints for retrieving and managing network-related data.
  - name: People Lists
    description: Endpoints for retrieving and managing lists of people in the system.
  - name: People
    description: Endpoints for retrieving information about actors, directors, and others.
  - name: Search
    description: Endpoints for performing searches across multiple categories.
  - name: Reviews
    description: Endpoints for managing and displaying reviews from users.
  - name: Trending
    description: Endpoints for retrieving trending content based on popularity.
  - name: TV Series Lists
    description: Endpoints for retrieving and managing lists of TV series.
  - name: TV Series
    description: Endpoints for retrieving detailed information about TV series.
  - name: TV Seasons
    description: Endpoints for retrieving and managing information about TV seasons.
  - name: TV Episodes
    description: Endpoints for retrieving and managing information about TV episodes.
  - name: TV Episode Groups
    description: Endpoints for managing groups of TV episodes organized by criteria.
  - name: Watch Providers
    description: >-
      Endpoints for retrieving availability information from streaming
      providers.
  - name: Auth
    description: >-
      Endpoints for managing version4 authentication, including login and user
      sessions.
  - name: Lists
    description: >-
      Endpoints for managing version4 authentication, including login and user
      sessions.
paths:
  /discover/tv:
    get:
      tags:
        - Discover
      summary: TV
      description: |
        This endpoint find movies using over 30 filters and sort options.
      operationId: discoverTV
      parameters:
        - name: air_date.gte
          in: query
          required: false
          schema:
            type: string
            format: date
          description: >-
            Filters results for air dates greater than or equal to the specified
            date.
        - name: air_date.lte
          in: query
          required: false
          schema:
            type: string
            format: date
          description: >-
            Filters results for air dates less than or equal to the specified
            date.
        - name: first_air_date_year
          in: query
          required: false
          schema:
            type: integer
          description: Filters results by the first air date year.
        - name: first_air_date.gte
          in: query
          required: false
          schema:
            type: string
            format: date
          description: >-
            Filters results for first air dates greater than or equal to the
            specified date.
        - name: first_air_date.lte
          in: query
          required: false
          schema:
            type: string
            format: date
          description: >-
            Filters results for first air dates less than or equal to the
            specified date.
        - name: include_adult
          in: query
          required: false
          schema:
            type: boolean
          description: Defaults to false. Include adult content if true.
        - name: include_null_first_air_dates
          in: query
          required: false
          schema:
            type: boolean
          description: Defaults to false. Include items with null first air dates if true.
        - name: language
          in: query
          required: false
          schema:
            type: string
          description: Defaults to en-US. Specify the language filter for results.
        - name: page
          in: query
          required: false
          schema:
            type: integer
          description: Defaults to 1. Specify the page of results to retrieve.
        - name: screened_theatricaly
          in: query
          required: false
          schema:
            type: boolean
          description: Include only items that were screened theatrically if true.
        - name: sort_by
          in: query
          required: false
          schema:
            type: string
          description: >-
            Defaults to popularity.desc. Specify how results should be sorted
            (e.g., popularity, rating).
        - name: timezone
          in: query
          required: false
          schema:
            type: string
          description: Specify the timezone for the query (e.g., UTC, PST).
        - name: vote_average.gte
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/float'
          description: >-
            Filters results for vote average greater than or equal to the
            specified value.
        - name: vote_average.lte
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/float'
          description: >-
            Filters results for vote average less than or equal to the specified
            value.
        - name: vote_count.gte
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/float'
          description: >-
            Filters results for vote count greater than or equal to the
            specified value.
        - name: vote_count.lte
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/float'
          description: >-
            Filters results for vote count less than or equal to the specified
            value.
        - name: watch_region
          in: query
          required: false
          schema:
            type: string
          description: >-
            Use in conjunction with `with_watch_monetization_types` or
            `with_watch_providers` to filter by region.
        - name: with_companies
          in: query
          required: false
          schema:
            type: string
          description: Can be a comma, pipe, or space-separated list of company IDs.
        - name: with_genres
          in: query
          required: false
          schema:
            type: string
          description: Can be a comma, pipe, or space-separated list of genre IDs.
        - name: with_keywords
          in: query
          required: false
          schema:
            type: string
          description: Can be a comma (AND) or pipe (OR) separated query of keyword IDs.
        - name: with_network
          in: query
          required: false
          schema:
            type: integer
          description: Filter by network ID.
        - name: with_origin_country
          in: query
          required: false
          schema:
            type: string
          description: Filter by country of origin.
        - name: with_original_language
          in: query
          required: false
          schema:
            type: string
          description: Filter by the original language of the content.
        - name: with_runtime.gte
          in: query
          required: false
          schema:
            type: integer
          description: >-
            Filters results for runtime greater than or equal to the specified
            value (in minutes).
        - name: with_runtime.lte
          in: query
          required: false
          schema:
            type: integer
          description: >-
            Filters results for runtime less than or equal to the specified
            value (in minutes).
        - name: with_status
          in: query
          required: false
          schema:
            type: string
          description: >-
            Filter by the status of the item (e.g., "released", "in
            production").
        - name: with_watch_monetization_types
          in: query
          required: false
          schema:
            type: string
          description: >-
            Can be a comma (AND) or pipe (OR) separated query of monetization
            types (e.g., "free", "ad-supported").
        - name: with_watch_providers
          in: query
          required: false
          schema:
            type: string
          description: >-
            Use in conjunction with `watch_region` to filter by watch providers
            (e.g., "Netflix", "Hulu").
        - name: without_companies
          in: query
          required: false
          schema:
            type: string
          description: Exclude specified companies (comma-separated).
        - name: without_genres
          in: query
          required: false
          schema:
            type: string
          description: Exclude specified genres (comma-separated).
        - name: without_keywords
          in: query
          required: false
          schema:
            type: string
          description: Exclude specified keywords (comma-separated).
        - name: without_watch_providers
          in: query
          required: false
          schema:
            type: string
          description: Exclude specified watch providers (comma-separated).
        - name: with_type
          in: query
          required: false
          schema:
            type: string
          description: >-
            Can be a comma (AND) or pipe (OR) separated query for types (e.g.,
            "movie", "tv_series").
      responses:
        '200':
          description: Successful
          content:
            application/json:
              schema:
                type: object
                properties:
                  page:
                    type: integer
                    description: Indicates the current page number
                  results:
                    type: array
                    description: Contains the list of data or items
                    items:
                      type: object
                      properties:
                        adult:
                          type: boolean
                        backdrop_path:
                          type: string
                        id:
                          type: integer
                        title:
                          type: string
                        original_language:
                          type: string
                        original_title:
                          type: string
                        overview:
                          type: string
                        poster_path:
                          type: string
                        genre_ids:
                          type: array
                        popularity:
                          type: number
                        first_air_date:
                          type: integer
                        vote_average:
                          type: number
                        vote_count:
                          type: integer
                  total_pages:
                    type: integer
                    description: Specifies the total number of pages available
                  total_results:
                    type: integer
                    description: >-
                      Represents the total number of items or records in a
                      dataset
                example:
                  page: 1
                  results:
                    - adult: false
                      backdrop_path: /2meX1nMdScFOoV4370rqHWKmXhY.jpg
                      genre_ids:
                        - 10759
                        - 9648
                        - 18
                      id: 93405
                      origin_country:
                        - KR
                      original_language: ko
                      original_name: 오징어 게임
                      overview: >-
                        Hundreds of cash-strapped players accept a strange
                        invitation to compete in children's games. Inside, a
                        tempting prize awaits — with deadly high stakes.
                      popularity: 3138.471
                      poster_path: /dDlEmu3EZ0Pgg93K2SVNLCjCSvE.jpg
                      first_air_date: '2021-09-17'
                      name: Squid Game
                      vote_average: 7.835
                      vote_count: 14318
                    - adult: false
                      backdrop_path: /jWXrQstj7p3Wl5MfYWY6IHqRpDb.jpg
                      genre_ids:
                        - 10763
                      id: 94722
                      origin_country:
                        - DE
                      original_language: de
                      original_name: Tagesschau
                      overview: >-
                        German daily news program, the oldest still existing
                        program on German television.
                      popularity: 2713.543
                      poster_path: /7dFZJ2ZJJdcmkp05B9NWlqTJ5tq.jpg
                      first_air_date: '1952-12-26'
                      name: Tagesschau
                      vote_average: 6.8
                      vote_count: 237
                    - adult: false
                      backdrop_path: /4N6zEMfZ57zNEQcM8gWeERFupMv.jpg
                      genre_ids:
                        - 16
                        - 10759
                        - 10765
                      id: 91363
                      origin_country:
                        - US
                      original_language: en
                      original_name: What If...?
                      overview: >-
                        Taking inspiration from the comic books of the same
                        name, each episode of this animated anthology series
                        questions, revisits and twists classic Marvel Cinematic
                        moments.
                      popularity: 1670.462
                      poster_path: /lztz5XBMG1x6Y5ubz7CxfPFsAcW.jpg
                      first_air_date: '2021-08-11'
                      name: What If...?
                      vote_average: 8.131
                      vote_count: 4241
                      total_pages: 9432
                      total_results: 188632
components:
  schemas:
    float:
      type: number
      format: float
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.