> ## 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.

# Movie

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


**Advanced Filtering**

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.


## OpenAPI

````yaml get /discover/movie
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/movie:
    get:
      tags:
        - Discover
      summary: Movie
      description: |
        This endpoint find movies using over 30 filters and sort options.
      operationId: discoverMovie
      parameters:
        - name: certificate
          in: query
          required: false
          schema:
            type: string
          description: Use in conjunction with region
        - name: certification.gte
          in: query
          required: false
          schema:
            type: string
          description: Use in conjunction with region
        - name: certification.lte
          in: query
          required: false
          schema:
            type: string
          description: Use in conjunction with region
        - name: certification_country
          in: query
          required: false
          schema:
            type: string
          description: >-
            Use in conjunction with the certification, certification.gte, and
            certification.lte filters
        - name: include_adult
          in: query
          required: false
          schema:
            type: boolean
          description: Defaults to false
        - name: include_video
          in: query
          required: false
          schema:
            type: boolean
          description: Defaults to false
        - name: language
          in: query
          required: false
          description: Defaults to en-US
          schema:
            type: string
        - name: page
          in: query
          required: false
          schema:
            type: string
          description: Defaults to 1
        - name: primary_release_year
          in: query
          required: false
          schema:
            type: integer
          description: Use in conjunction with region
        - name: primary_release_date.gte
          in: query
          required: false
          schema:
            type: string
            format: date
          description: Use in conjunction with region
        - name: primary_release_date.lte
          in: query
          required: false
          schema:
            type: string
            format: date
          description: Use in conjunction with region
        - name: region
          in: query
          required: false
          schema:
            type: string
          description: Use in conjunction with region
        - name: release_date.gte
          in: query
          required: false
          schema:
            type: string
            format: date
          description: Use in conjunction with region
        - name: release_date.lte
          in: query
          required: false
          schema:
            type: string
            format: date
          description: Use in conjunction with region
        - name: sort_by
          in: query
          required: false
          schema:
            type: string
          description: Defaults to popularity.desc
        - name: vote_average.gte
          in: query
          required: false
          schema:
            type: number
            format: float
          description: Minimum average vote score to include
        - name: vote_average.lte
          in: query
          required: false
          schema:
            type: number
            format: float
          description: Minimum average vote score to include
        - name: vote_count.gte
          in: query
          required: false
          schema:
            type: number
            format: float
          description: Minimum average vote score to include
        - name: vote_count.lte
          in: query
          required: false
          schema:
            type: number
            format: float
          description: Minimum average vote score to include
        - name: watch_region
          in: query
          required: false
          schema:
            type: string
          description: >-
            Use in conjunction with with_watch_monetization_types or
            with_watch_providers
        - name: with_cast
          in: query
          required: false
          schema:
            type: string
          description: Can be a comma, pipe or separated query
        - name: with_companies
          in: query
          required: false
          schema:
            type: string
          description: Can be a comma, pipe or separated query
        - name: with_crew
          in: query
          required: false
          schema:
            type: string
          description: Can be a comma, pipe or separated query
        - name: with_genres
          in: query
          required: false
          schema:
            type: string
          description: Can be a comma, pipe or separated query
        - name: with_keywords
          in: query
          required: false
          schema:
            type: string
          description: Can be a comma (AND) or pipe (OR) separated query
        - name: with_origin_country
          in: query
          required: false
          schema:
            type: string
          description: Use in conjunction with region
        - name: with_original_language
          in: query
          required: false
          schema:
            type: string
          description: Use in conjunction with region
        - name: with_people
          in: query
          required: false
          schema:
            type: string
          description: Can be a comma (AND) or pipe (OR) separated query
        - name: with_release_type
          in: query
          required: false
          schema:
            type: integer
          description: >-
            Can be a comma (AND) or pipe (OR) separated query, can be used in
            conjunction with region
        - name: with_runtime.gte
          in: query
          required: false
          schema:
            type: integer
          description: Use in conjunction with region
        - name: with_runtime.lte
          in: query
          required: false
          schema:
            type: integer
          description: Use in conjunction with region
        - name: with_watch_monetization_types
          in: query
          required: false
          schema:
            type: string
          description: Can be a comma (AND) or pipe (OR) separated query
        - name: with_watch_providers
          in: query
          required: false
          schema:
            type: string
          description: >-
            Use in conjunction with watch_region, can be a comma (AND) or pipe
            (OR) separated query
        - name: without_companies
          in: query
          required: false
          schema:
            type: string
          description: Use in conjunction with region
        - name: without_genres
          in: query
          required: false
          schema:
            type: string
          description: Use in conjunction with region
        - name: without_keywords
          in: query
          required: false
          schema:
            type: string
          description: Use in conjunction with region
        - name: without_watch_providers
          in: query
          required: false
          schema:
            type: string
          description: Use in conjunction with region
        - name: year
          in: query
          required: false
          schema:
            type: integer
          description: Use in conjunction with region
      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
                        release_date:
                          type: string
                        video:
                          type: boolean
                        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: /euYIwmwkmz95mnXvufEmbL6ovhZ.jpg
                      genre_ids:
                        - 28
                        - 12
                        - 18
                      id: 558449
                      original_language: en
                      original_title: Gladiator II
                      overview: >-
                        Years after witnessing the death of the revered hero
                        Maximus at the hands of his uncle, Lucius is forced to
                        enter the Colosseum after his home is conquered by the
                        tyrannical Emperors who now lead Rome with an iron fist.
                        With rage in his heart and the future of the Empire at
                        stake, Lucius must look to his past to find strength and
                        honor to return the glory of Rome to its people.
                      popularity: 7979.938
                      poster_path: /2cxhvwyEwRlysAmRH4iodkvo0z5.jpg
                      release_date: '2024-11-05'
                      title: Gladiator II
                      video: false
                      vote_average: 6.781
                      vote_count: 1622
                    - adult: false
                      backdrop_path: /6qld2YxAO9gdEblo0rsEb8BcYKO.jpg
                      genre_ids:
                        - 10749
                        - 18
                      id: 1156593
                      original_language: es
                      original_title: Culpa tuya
                      overview: >-
                        The love between Noah and Nick seems unwavering despite
                        their parents' attempts to separate them. But his job
                        and her entry into college open up their lives to new
                        relationships that will shake the foundations of both
                        their relationship and the Leister family itself.
                      popularity: 5541.871
                      poster_path: /1sQA7lfcF9yUyoLYC0e6Zo3jmxE.jpg
                      release_date: '2024-12-26'
                      title: Your Fault
                      video: false
                      vote_average: 7.737
                      vote_count: 300
                    - adult: false
                      backdrop_path: /cjEcqdRdPQJhYre3HUAc5538Gk8.jpg
                      genre_ids:
                        - 28
                        - 14
                        - 35
                      id: 845781
                      original_language: en
                      original_title: Red One
                      overview: >-
                        After Santa Claus (codename: Red One) is kidnapped, the
                        North Pole's Head of Security must team up with the
                        world's most infamous tracker in a globe-trotting,
                        action-packed mission to save Christmas.
                      popularity: 4938.342
                      poster_path: /cdqLnri3NEGcmfnqwk2TSIYtddg.jpg
                      release_date: '2024-10-31'
                      title: Red One
                      video: false
                      vote_average: 7.051
                      vote_count: 1573
                      total_pages: 17910
                      total_results: 158200
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

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