NAME

Net::LastFM - A simple interface to the Last.fm API

SYNOPSIS

my $lastfm = Net::LastFM->new(
    api_key    => 'XXX',
    api_secret => 'YYY',
);
my $data = $lastfm->request_signed(
    method => 'user.getRecentTracks',
    user   => 'lglb',
);

DESCRIPTION

The module provides a simple interface to the Last.fm API. To use this module, you must first sign up at http://www.last.fm/api to receive an API key and secret.

You can then make requests on the API - most of the requests are signed. You pass in a hash of paramters and a data structure mirroring the response is returned.

This module confesses if there is an error.

METHODS

request

This makes an unsigned request:

my $data = $lastfm->request( method => 'auth.gettoken' );

request_signed

This makes a signed request:

my $data = $lastfm->request_signed(
    method => 'user.getRecentTracks',
    user   => 'lglb',
);

create_http_request

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

my $http_request = $lastfm->create_http_request(
    method => 'auth.gettoken'
);

create_http_request_signed

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

my $http_request = $lastfm->create_http_request_signed(
    method => 'user.getRecentTracks',
    user   => 'lglb',
);

AUTHOR

Leon Brocard [email protected]

COPYRIGHT

Copyright (C) 2008-9, Leon Brocard.

LICENSE

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