OMDb
    OMDb
    • OMDb Search
      GET

      OMDb Search

      http://www.omdbapi.com/
      http://www.omdbapi.com/
      http://www.omdbapi.com/
      http://www.omdbapi.com/
      GET
      /
      Find a movie, series or episode from the OMDb by title, IMDb-id or by free-text search
      Request Request Example
      Shell
      JavaScript
      Java
      Swift
      curl --location --request GET 'http://www.omdbapi.com//?r='
      Response Response Example
      {
    "Actors": "string",
    "Awards": "string",
    "BoxOffice": "string",
    "Country": "string",
    "DVD": "string",
    "Director": "string",
    "Genre": "string",
    "Language": "string",
    "Metascore": "string",
    "Plot": "string",
    "Poster": "string",
    "Production": "string",
    "Rated": "string",
    "Released": "string",
    "Response": "string",
    "Runtime": "string",
    "Search": [
        {
            "Poster": "string",
            "Title": "string",
            "Type": "string",
            "Year": "string",
            "imdbID": "string"
        }
    ],
    "Title": "string",
    "Type": "string",
    "Website": "string",
    "Writer": "string",
    "Year": "string",
    "imdbID": "string",
    "imdbRating": "string",
    "imdbVotes": "string",
    "tomatoConsensus": "string",
    "tomatoFresh": "string",
    "tomatoImage": "string",
    "tomatoMeter": "string",
    "tomatoRating": "string",
    "tomatoReviews": "string",
    "tomatoRotten": "string",
    "tomatoURL": "string",
    "tomatoUserMeter": "string",
    "tomatoUserRating": "string",
    "tomatoUserReviews": "string",
    "totalResults": "string",
    "totalSeasons": "string"
}

      Request

      Query Params
      t
      string 
      optional
      Movie title to search for. One of t, i or s is required.
      i
      string 
      optional
      A valid IMDb ID (e.g. tt1285016). One of t, i or s is required.
      s
      string 
      optional
      Movie title to search for. One of t, i or s is required.
      y
      integer 
      optional
      Year of release.
      type
      string 
      optional
      Type of result to return.
      plot
      string 
      optional
      Return short or full plot.
      tomatoes
      string 
      optional
      Include Rotten Tomatoes ratings.
      r
      string 
      required
      The data type to return.
      v
      integer 
      optional
      API version (reserved for future use).
      page
      integer 
      optional
      Page number to return.
      callback
      string 
      optional
      JSONP callback name.

      Responses

      🟢200Default response
      application/json
      Body
      Actors
      string 
      optional
      Awards
      string 
      optional
      BoxOffice
      string 
      optional
      Country
      string 
      optional
      DVD
      string 
      optional
      Director
      string 
      optional
      Genre
      string 
      optional
      Language
      string 
      optional
      Metascore
      string 
      optional
      Plot
      string 
      optional
      Poster
      string 
      optional
      Production
      string 
      optional
      Rated
      string 
      optional
      Released
      string 
      optional
      Response
      string 
      required
      Runtime
      string 
      optional
      Search
      array [object {5}] 
      optional
      Poster
      string 
      required
      Title
      string 
      required
      Type
      string 
      required
      Year
      string 
      required
      imdbID
      string 
      required
      Title
      string 
      optional
      Type
      string 
      optional
      Website
      string 
      optional
      Writer
      string 
      optional
      Year
      string 
      optional
      imdbID
      string 
      optional
      imdbRating
      string 
      optional
      imdbVotes
      string 
      optional
      tomatoConsensus
      string 
      optional
      tomatoFresh
      string 
      optional
      tomatoImage
      string 
      optional
      tomatoMeter
      string 
      optional
      tomatoRating
      string 
      optional
      tomatoReviews
      string 
      optional
      tomatoRotten
      string 
      optional
      tomatoURL
      string 
      optional
      tomatoUserMeter
      string 
      optional
      tomatoUserRating
      string 
      optional
      tomatoUserReviews
      string 
      optional
      totalResults
      string 
      optional
      totalSeasons
      string 
      optional
      Built with