NAME

WebService::EchoNest - A simple interface to the EchoNest API

SYNOPSIS

  my $echonest = WebService::EchoNest->new(
      api_key    => 'XXX',
  );
  
  my $data = $echonest->request('artist/search',
    name   => 'Radiohead',
    bucket => ['biographies'],
    limit  => 'true'
  );

DESCRIPTION

The module provides a simple interface to the EchoNest API. To use this module, you must first sign up at http://developer.echonest.com/ to receive an API key.

You can then make requests on the API. You pass in a method name and hash of paramters, and a data structure mirroring the response is returned.

This module confesses if there is an error.

METHODS

request

This makes a request:

  my $data = $echonest->request('artist/search',
    name   => 'Black Moth Super Rainbow',
    bucket => ['images'],
    limit  => 'true'
  );

create_http_request

If you want to integrate this module into another HTTP framework, this method will create an HTTP::Request object:

  my $http_request = $echonest->create_http_request('artist/search',
    name   => 'Black Moth Super Rainbow',
    bucket => ['images'],
    limit  => 'true'
  );

AUTHOR

Nick Langridge <nickl@cpan.org>

CREDITS

This module was based on Net::LastFM by Leon Brocard.

COPYRIGHT

Copyright (C) 2013 Nick Langridge

LICENSE

This module is free software; you can redistribute it or modify it under the same terms as Perl itself.