> ## 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 > Get the videos that belong to a TV season. ## OpenAPI ````yaml api-reference/openapi.json get /3/tv/{{series_id}}/season/{{season_number}}/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/tv/{{series_id}}/season/{{season_number}}/videos: parameters: - name: series_id in: path required: true schema: type: string - name: season_number in: path required: true schema: type: string get: tags: - TV Seasons summary: Videos description: Get the videos that belong to a TV season. operationId: videos2 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=23384 Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Date: schema: type: string example: Sat, 11 Jan 2025 16:30:44 GMT ETag: schema: type: string example: W/"ae31034cb6e584fe854f3cb709a67ab6" 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 3502b4da22916485af0d3edbb185fb9c.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: pYQ1lcdmCzJYaLmaiQM_Mb-oJUgf7LLP7BJjMj3w-esM4EJVf7GT-Q== 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: '3018' x-memc-expires: schema: type: string example: '23384' x-memc-key: schema: type: string example: daf64c081c7825230e123f11679f8d17 content: application/json: schema: type: object properties: id: type: number example: 3578 results: type: array items: type: object properties: id: type: string example: 5336d65dc3a3680e7f0012f3 iso_3166_1: type: string example: US iso_639_1: type: string example: en key: type: string example: ccuuThlb5Vg name: type: string example: Breaking Bad Season 5 Trailer [HQ] official: type: boolean example: false published_at: type: string example: '2012-06-26T20:31:08.000Z' site: type: string example: YouTube size: type: number example: 480 type: type: string example: Trailer example: - id: 5336d65dc3a3680e7f0012f3 iso_3166_1: US iso_639_1: en key: ccuuThlb5Vg name: Breaking Bad Season 5 Trailer [HQ] official: false published_at: '2012-06-26T20:31:08.000Z' site: YouTube size: 480 type: Trailer - id: 5336d73ac3a3680e87001313 iso_3166_1: US iso_639_1: en key: gAIL5SQ3QFs name: Breaking Bad Season 5 Teaser - Walt's On Top [HD] official: false published_at: '2012-06-26T20:29:04.000Z' site: YouTube size: 480 type: Teaser - id: 5336d71fc3a3680e70001244 iso_3166_1: US iso_639_1: en key: I3An9mDuf7E name: Breaking Bad Season 5 Teaser - I Won [HD] official: false published_at: '2012-06-22T11:31:24.000Z' site: YouTube size: 480 type: Teaser - id: 5336d677c3a3680e8f0013d9 iso_3166_1: US iso_639_1: en key: bXN2skxH5qU name: 'Breaking Bad Season 5 Promo #1 - We Are Done [HD]' official: false published_at: '2012-06-18T11:17:42.000Z' site: YouTube size: 480 type: Teaser - id: 5336d6b6c3a3680e8f0013de iso_3166_1: US iso_639_1: en key: oNPfvEseRdY name: 'Breaking Bad Season 5 Promo #2 - Scared [HD]' official: false published_at: '2012-06-18T11:11:43.000Z' site: YouTube size: 480 type: Teaser - id: 5336d703c3a3680e70001241 iso_3166_1: US iso_639_1: en key: Z-gURIpg5f4 name: >- Breaking Bad Season 5 Teaser - The King is Dead, All Hail the King [HQ] official: false published_at: '2012-06-18T10:49:48.000Z' site: YouTube size: 480 type: Trailer examples: Videos: value: id: 3578 results: - id: 5336d65dc3a3680e7f0012f3 iso_3166_1: US iso_639_1: en key: ccuuThlb5Vg name: Breaking Bad Season 5 Trailer [HQ] official: false published_at: '2012-06-26T20:31:08.000Z' site: YouTube size: 480 type: Trailer - id: 5336d73ac3a3680e87001313 iso_3166_1: US iso_639_1: en key: gAIL5SQ3QFs name: Breaking Bad Season 5 Teaser - Walt's On Top [HD] official: false published_at: '2012-06-26T20:29:04.000Z' site: YouTube size: 480 type: Teaser - id: 5336d71fc3a3680e70001244 iso_3166_1: US iso_639_1: en key: I3An9mDuf7E name: Breaking Bad Season 5 Teaser - I Won [HD] official: false published_at: '2012-06-22T11:31:24.000Z' site: YouTube size: 480 type: Teaser - id: 5336d677c3a3680e8f0013d9 iso_3166_1: US iso_639_1: en key: bXN2skxH5qU name: 'Breaking Bad Season 5 Promo #1 - We Are Done [HD]' official: false published_at: '2012-06-18T11:17:42.000Z' site: YouTube size: 480 type: Teaser - id: 5336d6b6c3a3680e8f0013de iso_3166_1: US iso_639_1: en key: oNPfvEseRdY name: 'Breaking Bad Season 5 Promo #2 - Scared [HD]' official: false published_at: '2012-06-18T11:11:43.000Z' site: YouTube size: 480 type: Teaser - id: 5336d703c3a3680e70001241 iso_3166_1: US iso_639_1: en key: Z-gURIpg5f4 name: >- Breaking Bad Season 5 Teaser - The King is Dead, All Hail the King [HQ] official: false published_at: '2012-06-18T10:49:48.000Z' site: YouTube size: 480 type: Trailer ````