2.1 Deprecation Notice!

Please be aware that the 2.1 version of our API has been deprecated. 2.1 will be shut down on September 15, 2013. It has been replaced by v3. You can read the new API documentation here.

Movie.search

The Movie.search method is the easiest and quickest way to search for a movie. It is a mandatory method in order to get the movie id to pass to (as an example) the Movie.getInfo method.

Example URL

http://api.themoviedb.org/2.1/Movie.search/en/xml/APIKEY/Transformers

Example URL with year

http://api.themoviedb.org/2.1/Movie.search/en/xml/APIKEY/Transformers+2007

Options

Language: IETF Language Tag, e.g. en-US

Type: Type can be xml, yaml or json.

API Key: The API key we supplied you with for your account.

Title: The title of the movie you are searching for. Note: you can add the year of the movie to your search string to narrow your results.

In the event that you request a language that has not been translated, the data will default back to English. This can be checked with the 'translated' boolean element.

The last_modified_at time is UTC.

Example Response

<OpenSearchDescription xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/"> 
  <opensearch:Query searchTerms="transformers"/> 
  <opensearch:totalResults>2</opensearch:totalResults> 
  <movies> 
    <movie> 
      <score>8.582207</score> 
      <popularity>3</popularity> 
      <translated>true</translated> 
      <adult>false</adult> 
      <language>en</language> 
      <original_name>Transformers</original_name> 
      <name>Transformers</name> 
      <alternative_name>The Transformers</alternative_name> 
      <type>movie</type> 
      <id>1858</id> 
      <imdb_id>tt0418279</imdb_id> 
      <url>http://www.themoviedb.org/movie/1858</url> 
      <votes>28</votes>
      <rating>7.2</rating> 
      <certification>PG-13</certification> 
      <overview>The Earth is caught in the middle of an intergalactic war between two races of robots, the heroic Autobots and the evil Decepticons, which are able to change into a variety of objects, including cars, trucks, planes and other technological creations.</overview> 
      <released>2007-07-04</released> 
      <images> 
        <image type="poster" url="http://hwcdn.themoviedb.org/posters/304/4bc91347017a3c57fe007304/transformers-original.jpg" size="original" id="4bc91347017a3c57fe007304"/> 
        <image type="poster" url="http://hwcdn.themoviedb.org/posters/304/4bc91347017a3c57fe007304/transformers-mid.jpg" size="mid" id="4bc91347017a3c57fe007304"/> 
        <image type="poster" url="http://hwcdn.themoviedb.org/posters/304/4bc91347017a3c57fe007304/transformers-cover.jpg" size="cover" id="4bc91347017a3c57fe007304"/> 
        <image type="poster" url="http://hwcdn.themoviedb.org/posters/304/4bc91347017a3c57fe007304/transformers-thumb.jpg" size="thumb" id="4bc91347017a3c57fe007304"/> 
        <image type="backdrop" url="http://hwcdn.themoviedb.org/backdrops/2ce/4bc91339017a3c57fe0072ce/transformers-original.jpg" size="original" id="4bc91339017a3c57fe0072ce"/> 
        <image type="backdrop" url="http://hwcdn.themoviedb.org/backdrops/2ce/4bc91339017a3c57fe0072ce/transformers-poster.jpg" size="poster" id="4bc91339017a3c57fe0072ce"/> 
        <image type="backdrop" url="http://hwcdn.themoviedb.org/backdrops/2ce/4bc91339017a3c57fe0072ce/transformers-thumb.jpg" size="thumb" id="4bc91339017a3c57fe0072ce"/> 
      </images> 
      <last_modified_at>2010-04-26 03:26:14</last_modified_at> 
    </movie> 
    <movie> 
      <score>6.8657656</score> 
      <popularity>3</popularity> 
      <translated>true</translated> 
      <adult>false</adult> 
      <language>en</language> 
      <original_name>Transformations</original_name> 
      <name>Transformations</name> 
      <alternative_name></alternative_name> 
      <type>movie</type> 
      <id>28800</id> 
      <imdb_id>tt0094632</imdb_id> 
      <url>http://www.themoviedb.org/movie/28800</url> 
      <rating>0.0</rating> 
      <certification></certification> 
      <overview>No overview found.</overview> 
      <released>1988-09-02</released> 
      <images> 
        <image type="poster" url="http://hwcdn.themoviedb.org/posters/b32/4bc97113017a3c57fe033b32/transformations-original.jpg" size="original" id="4bc97113017a3c57fe033b32"/> 
        <image type="poster" url="http://hwcdn.themoviedb.org/posters/b32/4bc97113017a3c57fe033b32/transformations-mid.jpg" size="mid" id="4bc97113017a3c57fe033b32"/> 
        <image type="poster" url="http://hwcdn.themoviedb.org/posters/b32/4bc97113017a3c57fe033b32/transformations-cover.jpg" size="cover" id="4bc97113017a3c57fe033b32"/> 
        <image type="poster" url="http://hwcdn.themoviedb.org/posters/b32/4bc97113017a3c57fe033b32/transformations-thumb.jpg" size="thumb" id="4bc97113017a3c57fe033b32"/> 
      </images> 
      <version>6</version>
      <last_modified_at>2010-04-17 02:28:03</last_modified_at> 
    </movie> 
  </movies> 
</OpenSearchDescription>