> ## 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. # Movie > Search for movies by their original, translated and alternative titles. ## OpenAPI ````yaml api-reference/openapi.json get /3/search/movie 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/search/movie: get: tags: - Search summary: Movie description: Search for movies by their original, translated and alternative titles. operationId: movie1 parameters: - name: query in: query schema: type: string example: '%22Big%20Red%20One%22' - name: include_adult in: query schema: type: string example: 'false' - name: language in: query schema: type: string example: en-US - name: page in: query schema: type: string example: '1' responses: '200': description: Movie headers: Alt-Svc: schema: type: string example: h3=":443"; ma=86400 Cache-Control: schema: type: string example: public, max-age=25892 Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Date: schema: type: string example: Fri, 10 Jan 2025 15:25:03 GMT ETag: schema: type: string example: W/"ab020de8431cbae5ad6b2bbef6668b1a" 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 afc076a932b635d1fe9febfccf7103f0.cloudfront.net (CloudFront) X-Amz-Cf-Id: schema: type: string example: 64XuMHKidLGnSo8GOFtO0TwAHw0qVkpoZ1bmgF5GPPBF_FSxJh7-CA== 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: MISS, STORE x-memc-age: schema: type: string example: '0' x-memc-expires: schema: type: string example: '25892' x-memc-key: schema: type: string example: 7bf821559789048427c076c3afa6aee7 content: application/json: schema: type: object properties: page: type: number example: 1 results: type: array items: type: object properties: adult: type: boolean example: false backdrop_path: type: string nullable: true example: /mpRSzmUX0Lsimgg0M8hZRS2xrDC.jpg genre_ids: type: array items: type: number example: 18 example: - 18 - 10752 id: type: number example: 16121 original_language: type: string example: en original_title: type: string example: The Big Red One overview: type: string example: >- A veteran sergeant of World War I leads a squad in World War II, always in the company of the survivor Pvt. Griff, the writer Pvt. Zab, the Sicilian Pvt. Vinci and Pvt. Johnson, in Vichy French Africa, Sicily, D-Day at Omaha Beach, Belgium and France, and ending in a concentration camp in Czechoslovakia where they face the true horror of war. popularity: type: number example: 10.767 poster_path: type: string nullable: true example: /h0VcqQ3z1RroKk7WtiW0E6DDho2.jpg release_date: type: string example: '1980-01-22' title: type: string example: The Big Red One video: type: boolean example: false vote_average: type: number example: 6.7 vote_count: type: number example: 308 example: - adult: false backdrop_path: /mpRSzmUX0Lsimgg0M8hZRS2xrDC.jpg genre_ids: - 18 - 10752 id: 16121 original_language: en original_title: The Big Red One overview: >- A veteran sergeant of World War I leads a squad in World War II, always in the company of the survivor Pvt. Griff, the writer Pvt. Zab, the Sicilian Pvt. Vinci and Pvt. Johnson, in Vichy French Africa, Sicily, D-Day at Omaha Beach, Belgium and France, and ending in a concentration camp in Czechoslovakia where they face the true horror of war. popularity: 10.767 poster_path: /h0VcqQ3z1RroKk7WtiW0E6DDho2.jpg release_date: '1980-01-22' title: The Big Red One video: false vote_average: 6.7 vote_count: 308 - 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: 1892.703 poster_path: /cdqLnri3NEGcmfnqwk2TSIYtddg.jpg release_date: '2024-10-31' title: Red One video: false vote_average: 7.1 vote_count: 1921 - adult: false backdrop_path: /qrszuQRpcITVvKD6eXKIX86Twob.jpg genre_ids: - 18 - 10752 id: 501906 original_language: en original_title: 'The Big Red One : The Reconstruction' overview: >- A re-working, re-editing, and restructuring of Sam Fuller's The Big Red One bringing it closer as originally envisioned by the late filmmaker. It includes forty-seven additional minutes which was not utilized in the film's original release. Supervised by Richard Schickel, Peter Bogdanovich, and editor Bryan McKenzie. popularity: 2.459 poster_path: /A7IqvfTQCNnl2W3eRxq3f4FkWUW.jpg release_date: '2005-05-03' title: 'The Big Red One : The Reconstruction' video: true vote_average: 8.6 vote_count: 5 - adult: false backdrop_path: /l055x0r3oJpiYgNgBzSBGPO9MaD.jpg genre_ids: - 99 id: 628843 original_language: en original_title: Sam Fuller & the Big Red One overview: >- A documentary shot during the production of Samuel Fuller's film The Big Red One. popularity: 2.036 poster_path: /pD7MOyFhAyWhUwxB1XI1EUKavYu.jpg release_date: '1984-02-04' title: Sam Fuller & the Big Red One video: false vote_average: 0 vote_count: 0 - adult: false backdrop_path: null genre_ids: - 99 id: 263102 original_language: en original_title: 'The Real Glory: Reconstructing ''The Big Red One''' overview: >- Documentary about the efforts to reconstruct Sam Fuller's The Big Red One closer to the film Fuller had originally envisioned. popularity: 0.564 poster_path: /zIykCqfuCRRzAd6I1p3dPY5K0R9.jpg release_date: '2005-05-03' title: 'The Real Glory: Reconstructing ''The Big Red One''' video: false vote_average: 6 vote_count: 1 - adult: false backdrop_path: null genre_ids: - 36 id: 1272624 original_language: en original_title: The True Story of the Big Red One overview: >- THE TRUE STORY OF THE BIG RED ONE is pitting Hollywood fiction against historical fact, where we'll examine the reality behind Samuel Fuller's great war movie "The Big Red One". Based upon Fuller's own World War II experiences, the film starred Lee Marvin as the intrepid sergeant of special infantry squadron in various campaigns of the war. Learn the dramatic story of the illustrious First Division of the U.S. Army - called the Big Red One because of the red numeral "1" on its uniforms' shoulders - from it's organization in 1917 through the present day. popularity: 0.001 poster_path: null release_date: '1998-03-01' title: The True Story of the Big Red One video: false vote_average: 0 vote_count: 0 total_pages: type: number example: 1 total_results: type: number example: 6 examples: Movie: value: page: 1 results: - adult: false backdrop_path: /mpRSzmUX0Lsimgg0M8hZRS2xrDC.jpg genre_ids: - 18 - 10752 id: 16121 original_language: en original_title: The Big Red One overview: >- A veteran sergeant of World War I leads a squad in World War II, always in the company of the survivor Pvt. Griff, the writer Pvt. Zab, the Sicilian Pvt. Vinci and Pvt. Johnson, in Vichy French Africa, Sicily, D-Day at Omaha Beach, Belgium and France, and ending in a concentration camp in Czechoslovakia where they face the true horror of war. popularity: 10.767 poster_path: /h0VcqQ3z1RroKk7WtiW0E6DDho2.jpg release_date: '1980-01-22' title: The Big Red One video: false vote_average: 6.7 vote_count: 308 - 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: 1892.703 poster_path: /cdqLnri3NEGcmfnqwk2TSIYtddg.jpg release_date: '2024-10-31' title: Red One video: false vote_average: 7.1 vote_count: 1921 - adult: false backdrop_path: /qrszuQRpcITVvKD6eXKIX86Twob.jpg genre_ids: - 18 - 10752 id: 501906 original_language: en original_title: 'The Big Red One : The Reconstruction' overview: >- A re-working, re-editing, and restructuring of Sam Fuller's The Big Red One bringing it closer as originally envisioned by the late filmmaker. It includes forty-seven additional minutes which was not utilized in the film's original release. Supervised by Richard Schickel, Peter Bogdanovich, and editor Bryan McKenzie. popularity: 2.459 poster_path: /A7IqvfTQCNnl2W3eRxq3f4FkWUW.jpg release_date: '2005-05-03' title: 'The Big Red One : The Reconstruction' video: true vote_average: 8.6 vote_count: 5 - adult: false backdrop_path: /l055x0r3oJpiYgNgBzSBGPO9MaD.jpg genre_ids: - 99 id: 628843 original_language: en original_title: Sam Fuller & the Big Red One overview: >- A documentary shot during the production of Samuel Fuller's film The Big Red One. popularity: 2.036 poster_path: /pD7MOyFhAyWhUwxB1XI1EUKavYu.jpg release_date: '1984-02-04' title: Sam Fuller & the Big Red One video: false vote_average: 0 vote_count: 0 - adult: false backdrop_path: null genre_ids: - 99 id: 263102 original_language: en original_title: 'The Real Glory: Reconstructing ''The Big Red One''' overview: >- Documentary about the efforts to reconstruct Sam Fuller's The Big Red One closer to the film Fuller had originally envisioned. popularity: 0.564 poster_path: /zIykCqfuCRRzAd6I1p3dPY5K0R9.jpg release_date: '2005-05-03' title: 'The Real Glory: Reconstructing ''The Big Red One''' video: false vote_average: 6 vote_count: 1 - adult: false backdrop_path: null genre_ids: - 36 id: 1272624 original_language: en original_title: The True Story of the Big Red One overview: >- THE TRUE STORY OF THE BIG RED ONE is pitting Hollywood fiction against historical fact, where we'll examine the reality behind Samuel Fuller's great war movie "The Big Red One". Based upon Fuller's own World War II experiences, the film starred Lee Marvin as the intrepid sergeant of special infantry squadron in various campaigns of the war. Learn the dramatic story of the illustrious First Division of the U.S. Army - called the Big Red One because of the red numeral "1" on its uniforms' shoulders - from it's organization in 1917 through the present day. popularity: 0.001 poster_path: null release_date: '1998-03-01' title: The True Story of the Big Red One video: false vote_average: 0 vote_count: 0 total_pages: 1 total_results: 6 ````