NAME

WebService::OMDB - Interface to http://www.omdbapi.com/

VERSION

version 1.140440

SYNOPSIS

  my $search_results = WebService::OMDB::search('The Geen Mile');
  # returns...
  [
    {
      'Year' => '1999',
      'Type' => 'movie',
      'imdbID' => 'tt0120689',
      'Title' => 'The Green Mile'
    },
    {
      'Year' => '1999',
      'Type' => 'movie',
      'imdbID' => 'tt0338255',
      'Title' => 'The Miracle of \'The Green Mile\''
    },
    {
      'Year' => '2006',
      'Type' => 'movie',
      'imdbID' => 'tt0960803',
      'Title' => 'Miracles and Mystery: Creating \'The Green Mile\''
    },
    {
      'Year' => '2009',
      'Type' => 'episode',
      'imdbID' => 'tt1903167',
      'Title' => 'The Green Mile'
    }
  ];

  my $id_result = WebService::OMDB::id('tt0120689');
  # returns...
  {
    'Director' => 'Frank Darabont',
    'imdbID' => 'tt0120689',
    'Poster' => '...',
    'Actors' => 'Tom Hanks, David Morse, Michael Clarke Duncan, Bonnie Hunt',
    'Metascore' => '61',
    'imdbRating' => '8.5',
    'imdbVotes' => '477,025',
    'Released' => '10 Dec 1999',
    'Awards' => 'Nominated for 4 Oscars. Another 15 wins & 23 nominations.',
    'Title' => 'The Green Mile',
    'Plot' => 'The lives of guards on Death Row are affected by one of their charges: a black man accused of child murder and rape, yet who has a mysterious gift.',
    'Year' => '1999',
    'Rated' => 'R',
    'Writer' => 'Stephen King (novel), Frank Darabont (screenplay)',
    'Type' => 'movie',
    'Runtime' => '189 min',
    'Genre' => 'Crime, Drama, Fantasy',
    'Language' => 'English, French',
    'Response' => 'True',
    'Country' => 'USA'
  };

  my $title_result = WebService::OMDB::title('The Green Mile');
  # returns the same as id

DESCRIPTION

WebService::OMDB is an interface to http://www.omdbapi.com/.

METHODS

search( $search_term, $options )

Searches based on the title. Returns an array of results.

search_term

String. Required.

options

The options shown at http://www.omdbapi.com/. Hash reference. Optional.

id( $id )

Gets a result based on the IMDB id. Returns a single result.

id

String. Required.

options

The options shown at http://www.omdbapi.com/. Hash reference. Optional.

title( $title )

Gets a result based on the title. Returns a single result.

title

String. Required.

options

The options shown at http://www.omdbapi.com/. Hash reference. Optional.

AUTHOR

Andrew Jones <andrew@arjones.co.uk>

COPYRIGHT AND LICENSE

This software is copyright (c) 2014 by Andrew Jones.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.