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

# Videos

> Videos



## OpenAPI

````yaml api-reference/openapi.json get /3/movie/{{movie_id}}/videos
openapi: 3.0.3
info:
  title: Themoviedb API
  description: >-
    Version 3 (stable) of The Movie Database (TMDB) API offers a concise list of
    available methods for movies, TV shows, actors, and images.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.themoviedb.org
  - url: https://api.themoviedb.org/3
security: []
tags:
  - name: Account
  - name: Authentication
    description: >-
      # How do I generate a session id?


      As outlined in the [getting started
      guide](https://developer.themoviedb.org/docs/getting-started), the basics
      to getting a user authenticated look like this:


      1. **Create a new request token**  

      2. **Get the user to authorize the request token**  

      3. **Create a new session id with the authorized request token**  


      Steps 1 and 3 should be fairly easy to understand, but let's walk through
      each to ensure clarity.


      ## Step 1: Create a request token


      The first step as a developer is to request a new token. This is a
      **temporary token** required to ask the user for permission to access
      their account. This token will automatically expire **after 60 minutes**
      if it's not used.


      ## Step 2: Ask the user for permission


      With a request token in hand, forward your user to the following URL:


      ```

      https://www.themoviedb.org/authenticate/{REQUEST_TOKEN}

      ```


      You can also pass this URL a `redirect_to` parameter, like so:


      ```

      https://www.themoviedb.org/authenticate/{REQUEST_TOKEN}?redirect_to=http://www.yourapp.com/approved

      ```


      Once the user has approved your request token, they will either be
      redirected to the URL you specified in the `redirect_to` parameter or to
      the `/authenticate/allow` path on TMDB. If they aren't redirected to a
      custom URL, the page will also include an `Authentication-Callback`
      header. This header contains the API call for step #3. You can either
      manually generate it or simply use the one we return.


      ## Step 3: Create a session ID


      By calling the **new session method** with the request token that has been
      approved by the user in Step 2, we will return a **new session_id**. This
      session can now be used to write user data. You should treat this key
      **like a password** and keep it secret.


      ## What about guest sessions?


      A **guest session** can be used to rate movies **without** requiring a
      registered TMDB user account. For more information about how to create a
      guest session, see
      [here](https://developer.themoviedb.org/docs/authentication).
  - name: Certification
  - name: Changes
  - name: Collections
  - name: Companies
  - name: Configuration
  - name: Credits
  - name: Discover
  - name: Find
  - name: Genres
  - name: Guest Session
  - name: Keywords
  - name: List
    description: >-
      ## v3 or v4 list? 😕


      You may have noticed that the a v4 version of our list API exists. While
      these v3 list methods continue to work, all of the new features you can
      see on our website are only available if you switch to the v4 lists.


      **What are some of the improvements in v4?**


      - You can import "unlimited" items in a single request
          
      - You can use mixed type (movie and TV) lists
          
      - You can use private lists
          
      - You can add and use comments per item
          
      - There are more sort options
          
      - They are faster
          
      - Check the v4 documentation for more information.
  - name: Movie Lists
  - name: Movies
  - name: Networks
  - name: People Lists
  - name: People
  - name: Reviews
  - name: Search
  - name: Trending
  - name: TV Series Lists
  - name: TV Series
  - name: TV Seasons
  - name: TV Episodes
  - name: TV Episode Groups
  - name: Watch Providers
paths:
  /3/movie/{{movie_id}}/videos:
    parameters:
      - name: movie_id
        in: path
        required: true
        schema:
          type: string
    get:
      tags:
        - Movies
      summary: Videos
      description: Videos
      operationId: videos
      parameters:
        - name: language
          in: query
          schema:
            type: string
            example: en-US
      responses:
        '200':
          description: Videos
          headers:
            Alt-Svc:
              schema:
                type: string
                example: h3=":443"; ma=86400
            Cache-Control:
              schema:
                type: string
                example: public, max-age=6266
            Connection:
              schema:
                type: string
                example: keep-alive
            Content-Encoding:
              schema:
                type: string
                example: gzip
            Date:
              schema:
                type: string
                example: Wed, 08 Jan 2025 22:10:15 GMT
            ETag:
              schema:
                type: string
                example: W/"91bee41dd8830e1c19763e27e60d84d3"
            Server:
              schema:
                type: string
                example: openresty
            Transfer-Encoding:
              schema:
                type: string
                example: chunked
            Vary:
              schema:
                type: string
                example: Origin
            Via:
              schema:
                type: string
                example: >-
                  1.1 552902bab7d1a219a13b7843f4afebae.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              schema:
                type: string
                example: Zc2ikwL0QnLJaSXzaonyziq7KWCZakEqZISwSKyndvqPvllLO7LKBA==
            X-Amz-Cf-Pop:
              schema:
                type: string
                example: LOS50-P2
            X-Cache:
              schema:
                type: string
                example: Miss from cloudfront
            x-memc:
              schema:
                type: string
                example: HIT
            x-memc-age:
              schema:
                type: string
                example: '16274'
            x-memc-expires:
              schema:
                type: string
                example: '6266'
            x-memc-key:
              schema:
                type: string
                example: 1d14deeed35adc6cd67003b46b46c9c4
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: number
                    example: 845781
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          example: 676848eb52ab12dfea5e4573
                        iso_3166_1:
                          type: string
                          example: US
                        iso_639_1:
                          type: string
                          example: en
                        key:
                          type: string
                          example: lVqQwMlwH9s
                        name:
                          type: string
                          example: Kiernan Shipka and Lucy Liu Paint Each Other
                        official:
                          type: boolean
                          example: true
                        published_at:
                          type: string
                          example: '2024-12-21T19:00:32.000Z'
                        site:
                          type: string
                          example: YouTube
                        size:
                          type: number
                          example: 1080
                        type:
                          type: string
                          example: Featurette
                    example:
                      - id: 676848eb52ab12dfea5e4573
                        iso_3166_1: US
                        iso_639_1: en
                        key: lVqQwMlwH9s
                        name: Kiernan Shipka and Lucy Liu Paint Each Other
                        official: true
                        published_at: '2024-12-21T19:00:32.000Z'
                        site: YouTube
                        size: 1080
                        type: Featurette
                      - id: 6763c68794196aaed2fffcd6
                        iso_3166_1: US
                        iso_639_1: en
                        key: XlUu7QU_7I8
                        name: Quick Draw with the Cast
                        official: true
                        published_at: '2024-12-18T18:00:30.000Z'
                        site: YouTube
                        size: 1080
                        type: Featurette
                      - id: 675bd0e24b5280ff0c1bf99e
                        iso_3166_1: US
                        iso_639_1: en
                        key: syASIeI7I0E
                        name: Red One Comes Home
                        official: true
                        published_at: '2024-12-12T17:44:46.000Z'
                        site: YouTube
                        size: 1080
                        type: Featurette
                      - id: 67578c20e528400caac19d49
                        iso_3166_1: US
                        iso_639_1: en
                        key: c1nIlvynTC4
                        name: Streaming December 12
                        official: true
                        published_at: '2024-12-09T14:27:14.000Z'
                        site: YouTube
                        size: 1080
                        type: Teaser
                      - id: 6733ae63678d3856a76b4612
                        iso_3166_1: US
                        iso_639_1: en
                        key: TMDR2_4223Y
                        name: The Most Wonderful Time Of The Year Featurette
                        official: true
                        published_at: '2024-11-12T17:00:02.000Z'
                        site: YouTube
                        size: 1080
                        type: Featurette
                      - id: 672e7b7872ba92c1087a0294
                        iso_3166_1: US
                        iso_639_1: en
                        key: 9YumnnfaED8
                        name: Wish
                        official: true
                        published_at: '2024-11-08T15:45:12.000Z'
                        site: YouTube
                        size: 1080
                        type: Teaser
                      - id: 672e7b7f72ba92c1087a0297
                        iso_3166_1: US
                        iso_639_1: en
                        key: tJ-i_dFBsDc
                        name: Suit up
                        official: true
                        published_at: '2024-11-08T15:42:39.000Z'
                        site: YouTube
                        size: 1080
                        type: Teaser
                      - id: 672e7b8755fbf9881c5e9ca7
                        iso_3166_1: US
                        iso_639_1: en
                        key: BbShpkOEs6A
                        name: Let's Save Christmas
                        official: true
                        published_at: '2024-11-08T15:42:07.000Z'
                        site: YouTube
                        size: 1080
                        type: Teaser
                      - id: 672d93a1ebe21def08c8ebda
                        iso_3166_1: US
                        iso_639_1: en
                        key: vqTlP-3SlAs
                        name: The Rock x Thursday Night Football
                        official: true
                        published_at: '2024-11-08T00:59:59.000Z'
                        site: YouTube
                        size: 1080
                        type: Featurette
                      - id: 672d8bed6c10939a51515d17
                        iso_3166_1: US
                        iso_639_1: en
                        key: hwfgp7HvsU4
                        name: London Launch
                        official: true
                        published_at: '2024-11-07T09:35:01.000Z'
                        site: YouTube
                        size: 1080
                        type: Featurette
                      - id: 672c6569898d18e69095eee3
                        iso_3166_1: US
                        iso_639_1: en
                        key: CzlOv1bJugQ
                        name: Christmas Ad
                        official: true
                        published_at: '2024-11-06T17:29:45.000Z'
                        site: YouTube
                        size: 1080
                        type: Teaser
                      - id: 671d2fd0fefd1e0510004e1c
                        iso_3166_1: US
                        iso_639_1: en
                        key: 2CvdsyN5yKs
                        name: See it in IMAX
                        official: true
                        published_at: '2024-10-25T16:00:02.000Z'
                        site: YouTube
                        size: 1080
                        type: Featurette
                      - id: 671a9c696e4210780f78d650
                        iso_3166_1: US
                        iso_639_1: en
                        key: BJqPkhWglgk
                        name: TNT x Red One - Rugby Spot
                        official: true
                        published_at: '2024-10-24T13:35:16.000Z'
                        site: YouTube
                        size: 1080
                        type: Featurette
                      - id: 6712c08725c70b8b1d67e007
                        iso_3166_1: US
                        iso_639_1: en
                        key: ThJ9XCXLR44
                        name: Two Turtle Doves Featurette
                        official: true
                        published_at: '2024-10-18T16:00:34.000Z'
                        site: YouTube
                        size: 1080
                        type: Featurette
                      - id: 66f0c20f7300a5ba213b6f50
                        iso_3166_1: US
                        iso_639_1: en
                        key: 7l3hfD74X-4
                        name: Official Trailer 2
                        official: true
                        published_at: '2024-09-23T00:00:03.000Z'
                        site: YouTube
                        size: 1080
                        type: Trailer
                      - id: 667aea1e0585b4e5ef159a19
                        iso_3166_1: US
                        iso_639_1: en
                        key: U8XH3W0cMss
                        name: Official Trailer
                        official: true
                        published_at: '2024-06-25T16:00:14.000Z'
                        site: YouTube
                        size: 1080
                        type: Trailer
              examples:
                Videos:
                  value:
                    id: 845781
                    results:
                      - id: 676848eb52ab12dfea5e4573
                        iso_3166_1: US
                        iso_639_1: en
                        key: lVqQwMlwH9s
                        name: Kiernan Shipka and Lucy Liu Paint Each Other
                        official: true
                        published_at: '2024-12-21T19:00:32.000Z'
                        site: YouTube
                        size: 1080
                        type: Featurette
                      - id: 6763c68794196aaed2fffcd6
                        iso_3166_1: US
                        iso_639_1: en
                        key: XlUu7QU_7I8
                        name: Quick Draw with the Cast
                        official: true
                        published_at: '2024-12-18T18:00:30.000Z'
                        site: YouTube
                        size: 1080
                        type: Featurette
                      - id: 675bd0e24b5280ff0c1bf99e
                        iso_3166_1: US
                        iso_639_1: en
                        key: syASIeI7I0E
                        name: Red One Comes Home
                        official: true
                        published_at: '2024-12-12T17:44:46.000Z'
                        site: YouTube
                        size: 1080
                        type: Featurette
                      - id: 67578c20e528400caac19d49
                        iso_3166_1: US
                        iso_639_1: en
                        key: c1nIlvynTC4
                        name: Streaming December 12
                        official: true
                        published_at: '2024-12-09T14:27:14.000Z'
                        site: YouTube
                        size: 1080
                        type: Teaser
                      - id: 6733ae63678d3856a76b4612
                        iso_3166_1: US
                        iso_639_1: en
                        key: TMDR2_4223Y
                        name: The Most Wonderful Time Of The Year Featurette
                        official: true
                        published_at: '2024-11-12T17:00:02.000Z'
                        site: YouTube
                        size: 1080
                        type: Featurette
                      - id: 672e7b7872ba92c1087a0294
                        iso_3166_1: US
                        iso_639_1: en
                        key: 9YumnnfaED8
                        name: Wish
                        official: true
                        published_at: '2024-11-08T15:45:12.000Z'
                        site: YouTube
                        size: 1080
                        type: Teaser
                      - id: 672e7b7f72ba92c1087a0297
                        iso_3166_1: US
                        iso_639_1: en
                        key: tJ-i_dFBsDc
                        name: Suit up
                        official: true
                        published_at: '2024-11-08T15:42:39.000Z'
                        site: YouTube
                        size: 1080
                        type: Teaser
                      - id: 672e7b8755fbf9881c5e9ca7
                        iso_3166_1: US
                        iso_639_1: en
                        key: BbShpkOEs6A
                        name: Let's Save Christmas
                        official: true
                        published_at: '2024-11-08T15:42:07.000Z'
                        site: YouTube
                        size: 1080
                        type: Teaser
                      - id: 672d93a1ebe21def08c8ebda
                        iso_3166_1: US
                        iso_639_1: en
                        key: vqTlP-3SlAs
                        name: The Rock x Thursday Night Football
                        official: true
                        published_at: '2024-11-08T00:59:59.000Z'
                        site: YouTube
                        size: 1080
                        type: Featurette
                      - id: 672d8bed6c10939a51515d17
                        iso_3166_1: US
                        iso_639_1: en
                        key: hwfgp7HvsU4
                        name: London Launch
                        official: true
                        published_at: '2024-11-07T09:35:01.000Z'
                        site: YouTube
                        size: 1080
                        type: Featurette
                      - id: 672c6569898d18e69095eee3
                        iso_3166_1: US
                        iso_639_1: en
                        key: CzlOv1bJugQ
                        name: Christmas Ad
                        official: true
                        published_at: '2024-11-06T17:29:45.000Z'
                        site: YouTube
                        size: 1080
                        type: Teaser
                      - id: 671d2fd0fefd1e0510004e1c
                        iso_3166_1: US
                        iso_639_1: en
                        key: 2CvdsyN5yKs
                        name: See it in IMAX
                        official: true
                        published_at: '2024-10-25T16:00:02.000Z'
                        site: YouTube
                        size: 1080
                        type: Featurette
                      - id: 671a9c696e4210780f78d650
                        iso_3166_1: US
                        iso_639_1: en
                        key: BJqPkhWglgk
                        name: TNT x Red One - Rugby Spot
                        official: true
                        published_at: '2024-10-24T13:35:16.000Z'
                        site: YouTube
                        size: 1080
                        type: Featurette
                      - id: 6712c08725c70b8b1d67e007
                        iso_3166_1: US
                        iso_639_1: en
                        key: ThJ9XCXLR44
                        name: Two Turtle Doves Featurette
                        official: true
                        published_at: '2024-10-18T16:00:34.000Z'
                        site: YouTube
                        size: 1080
                        type: Featurette
                      - id: 66f0c20f7300a5ba213b6f50
                        iso_3166_1: US
                        iso_639_1: en
                        key: 7l3hfD74X-4
                        name: Official Trailer 2
                        official: true
                        published_at: '2024-09-23T00:00:03.000Z'
                        site: YouTube
                        size: 1080
                        type: Trailer
                      - id: 667aea1e0585b4e5ef159a19
                        iso_3166_1: US
                        iso_639_1: en
                        key: U8XH3W0cMss
                        name: Official Trailer
                        official: true
                        published_at: '2024-06-25T16:00:14.000Z'
                        site: YouTube
                        size: 1080
                        type: Trailer

````