NAME

Net::Spotify::Search - Perl interface to the Spotify Metadata API

VERSION

Version 0.01

SYNOPSIS

use Net::Spotify::Search;

my $search = Net::Spotify::Search->new();

# search the artist and get detailed information
# about all the related albums
my $response = $search->make_request(
    'track',
    q => 'june tune',
    page => 2,
);

DESCRIPTION

This module implements the interface to the search service of the Spotify Metadata API. It inherits most of the methods from Net::Spotify::Service.

http://developer.spotify.com/en/metadata-api/search/

METHODS

format_request

Builds the request used by make_request(). The URI format is: [base_url]/search/[version]/[method].[format]?q=[search_term]&page=[page] Ie. http://ws.spotify.com/search/1/track.xml?q=june%20tune&page=2

Returns an HTTP::Request object.

Parameters

Parameters are passed from make_request(). The first is a scalar, and the second a hash.

type

Represents the type of search. Possible values are: artist, album, track. Mandatory.

q

The search term. Mandatory.

page

The page of the result set to return. Defaults to 1. Optional.

SEE ALSO

Net::Spotify, Net::Spotify::Service, Net::Spotify::Lookup

AUTHOR

Edoardo Sabadelli, <edoardo at cpan.org>

BUGS

Please report any bugs or feature requests to bug-net-spotify at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Net-Spotify. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Net::Spotify

You can also look for information at:

ACKNOWLEDGEMENTS

This product uses a SPOTIFY API but is not endorsed, certified or otherwise approved in any way by Spotify. Spotify is the registered trade mark of the Spotify Group.

COPYRIGHT & LICENSE

Copyright 2009 Edoardo Sabadelli, all rights reserved.

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