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.