NAME
Net::Songkick - Perl wrapper for the Songkick API
SYNOPSIS
use Net::Songkick;
my $api_key = 'your_api_key';
my $sk = Net::Songkick->new({ api_key => $api_key });
# Returns XML by default
my $events = $sk->get_events;
# Or returns JSON
my $events = $sk->get_events({ format => 'json' });DESCRIPTION
This module presents a Perl wrapper around the Songkick API.
Songkick (https://www.songkick.com/) is a web site that tracks gigs around the world. Users can add information about gigs (both in the past and the future) and can track their attendance at those gigs.
For more details of the Songkick API see https://www.songkick.com/developer.
METHODS
Net::Songkick->new({ api_key => $api_key })
Creates a new object which can be used to request data from the Songkick API. Requires one parameter which is the user's API key.
To request an API key from Songkick, see https://www.songkick.com/api_key_requests/new.
Returns a Net::Songkick object if successful.
$sk->return_perl
Returns a Boolean value indicating whether or not this Net::Songkick object should return Perl data structures for requests.
$sk->parse_events_from_json($json_text)
Takes the JSON returns by a request for a list of events, parses the JSON and returns a list of Net::Songkick::JSON objects.
$sk->get_events({ ... options ... });
Gets a list of upcoming events from Songkick. Various parameters to control the events returned are supported for the full list see http://www.songkick.com/developer/event-search.
In addition, this method takes an extra parameter, format, which control the format of the data returned. This can be either xml, json or perl. If it is either xml or json then the method will return the raw XML or JSON from the Songkick API. If it is perl then this method will return a list of Net::Songkick::Event objects. If this parameter is omitted, then perl is assumed.
$sk->get_upcoming_events({ ... options ... });
Gets a list of upcoming events for a particular user from Songkick. This method accepts all of the same search parameters as get_events. It also supports the optional format parameter.
This method has another, mandatory, parameter called user. This is the username of the user that you want information about.
$sk->get_past_events({ ... options ... });
Gets a list of upcoming events for a particular user from Songkick.
This method has an optional parameter, page to control which page of the data you want to return. It also supports the format parameter.
This method has another, mandatory, parameter called user. This is the username of the user that you want information about.
$sk->get_venue_events({ ... options ...});
$sk->get_artist_events({ ... options ... });
$sk->get_metro_events({ ... options ... });
AUTHOR
Dave Cross <dave@perlhacks.com>
SEE ALSO
perl(1), http://www.songkick.com/, http://developer.songkick.com/
COPYRIGHT AND LICENSE
Copyright (C) 2010, Magnum Solutions Ltd. All Rights Reserved.
This script is free software; you can redistribute it and/or modify it under the same terms as Perl itself.