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>