WebService::MusicBrainz(3pm)

1WebService::MusicBrainzU(s3e)r Contributed Perl DocumentaWteiboSnervice::MusicBrainz(3)
2
3
4

NAME

6       WebService::MusicBrainz
7

SYNOPSIS

9           use WebService::MusicBrainz;
10
11           my $mb = WebService::MusicBrainz->new();
12
13           my $result = $mb->search($resource => { $search_key => 'search value' });
14           my $result = $mb->search($resource => { $search_key => 'search value', fmt => 'json' });  # fmt => 'json' is default
15
16           my $result_dom = $mb->search($resource => { $search_key => 'search value', fmt => 'xml' });
17

DESCRIPTION

19       API to search the musicbrainz.org database
20

VERSION

22       Version 1.0 and future releases are not backward compatible with
23       pre-1.0 releases.  This is a complete re-write using version 2.0 of the
24       MusicBrainz API and Mojolicious.
25

METHODS

27   new
28        my $mb = WebService::MusicBrainz->new();
29
30   search
31        my $result_list = $mb->search($resource => { param1 => 'value1' });
32
33        my $result = $mb->search($resource => { mbid => 'mbid' });
34
35        my $result_more = $mb->search($resource => { mbid => 'mbid', inc => 'extra stuff' });
36
37        Valid values for $resource are:  area, artist, event, instrument, label, recording, release, release-group, series, work, url
38       The default is to return decoded JSON as a perl data structure.  Specify format => 'xml' to return the results as an instance of Mojo::DOM.
39
40       Search by MBID
41
42         my $result = $mb->search($resource => { mbid => 'xxxxxx' });
43
44       The "inc" search parameter is only allowed when searching for any
45       particular "mbid".
46
47       Search area
48
49         my $area_list_results = $mb_ws->search(area => { iso => 'US-OH' });
50         my $area_list_results = $mb_ws->search(area => { area => 'cincinnati' });
51         my $area_list_results = $mb_ws->search(area => { alias => 'new york' });
52         my $area_list_results = $mb_ws->search(area => { sortname => 'new york' });
53         my $area_list_results = $mb_ws->search(area => { area => 'new york', type => 'city' });
54
55         my $area_result = $mb_ws->search(area => { mbid => '0573177b-9ff9-4643-80bc-ed2513419267' });
56         my $area_result = $mb_ws->search(area => { mbid => '0573177b-9ff9-4643-80bc-ed2513419267', inc => 'area-rels' });
57
58       Search artist
59
60        # JSON example
61        my $artists = $mb->search(artist => { artist => 'Ryan Adams' });
62        my $artists = $mb->search(artist => { artist => 'Ryan Adams', type => 'person' });
63
64        my $artist_country = $artists->{artists}->[0]->{country};
65
66        # XML example
67        my $artists = $mb->search(artist => { artist => 'Ryan Adams', type => 'person', fmt => 'xml' });
68
69        my $artist_country = $artists->at('country')->text;
70
71        # find this particular artist
72        my $artist = $mb->search(artist => { mbid => '5c2d2520-950b-4c78-84fc-78a9328172a3' });
73
74        # find this particular artist and include release and artist relations (members of the band)
75        my $artist = $mb->search(artist => { mbid => '5c2d2520-950b-4c78-84fc-78a9328172a3', inc => ['releases','artist-rels'] });
76
77        # artists that started in Cincinnati
78        my $artists = $mb->search(artist => { beginarea => 'Cincinnati' });
79
80       Search label
81
82        my $labels = $mb->search(label => { label => 'Death' });
83
84       Search recording
85
86        my $recordings = $mb->search(recording => { artist => 'Taylor Swift' });
87
88       Search release
89
90        my $releases = $mb->search(release => { release => 'Love Is Hell', status => 'official' });
91        print "RELEASE COUNT: ", $releases->{count}, "\n";
92

DEBUG

94       Set environment variable MUSICBRAINZ_DEBUG=1
95
96       ·
97        The URL that is generated for the search will output to STDOUT.
98
99       ·
100        The formatted output (JSON or XML) will be output to STDOUT
101

AUTHOR

103       Bob Faist <bob.faist@gmail.com>
104

COPYRIGHT AND LICENSE

106       Copyright 2006-2017 by Bob Faist
107
108       This library is free software; you can redistribute it and/or modify it
109       under the same terms as Perl itself.
110