Maestro.fm

for Developers

Library/Genre

From MaestroWikiAPI

Jump to: navigation, search

Library - Genre Browse

Returns XML to display the user's library grouped by genre name in ascending order.

URL 

http://www.maestro.fm/maestro_api?api_access_key=api_access_key&type=my_library&user_email=user@email.com&user_session_key=user_session_key&search_type=genre&current_page=0&linesPerPage=10&index_view=1&search_string=


Formats 

XML


HTTP Methods 

GET


Parameters 

api_access_key: Key given to you when you applied to use this API

type: the call type, in this case it must be "my_library"

user_email: user's email address associated with their Maestro account

user_session_key: user's user_session_key value provided on Account/Login

search_type: Possible options [genre] - Displays the results grouped by genre name in ascending order

current_page: Possible options [0-N] - Displays the page selected by default is set to 0

linesPerPage: Possible options [1-100] - Results to return per page. Max amount is 100 and the default is 10

index_view: Possible options [1] - This is required to group the results

search_string: Possible options [null] - Make sure this is set to NULL


Successful XML 

<maestro xmlns:p="http://www.maestro.fm" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<summary>
		<request_username>danesc</request_username>
		<request_date>20090517213952</request_date>
		<request_type>my_library</request_type>
		<total_pages>38</total_pages>
		<current_page>10</current_page>

		<number_of_results>380</number_of_results>
		<lines_per_page>10</lines_per_page>
	</summary>
	<response>
		<user_session_key>mbeWBYP1Ry9eKm4l1K8M</user_session_key>
		<user_valid>1</user_valid>
		<user_display></user_display>

		<section>
			<section_description>My Library</section_description>
			<item>
				<item_type>3</item_type>
				<item_identifier>ri3Uvql0xQZez44uVhEJTNIQkfk7mNad6e82Ut3S</item_identifier>
				<item_media_row>90</item_media_row>
				<item_display_name>Country%20Rock</item_display_name>

				<item_song_results_url>http://www.maestro.fm/maestro_api?api_access_key=KSDFJKCKLJKDLSJFLK34%26user_session_key=mbeWBYP1Ry9eKm4l1K8M%26user_email=dde%40danesc.com%26type=my_library%26search_string=Country%20Rock%26search_type=genre</item_song_results_url>
			</item>
			<item>
				<item_type>3</item_type>
				<item_identifier>XVwN5ULjA3UQO4dS2f4vOzdCNzVJmr9KM6iSa3Ck</item_identifier>
				<item_media_row>91</item_media_row>
				<item_display_name>Crossover</item_display_name>

				<item_song_results_url>http://www.maestro.fm/maestro_api?api_access_key=KSDFJKCKLJKDLSJFLK34%26user_session_key=mbeWBYP1Ry9eKm4l1K8M%26user_email=dde%40danesc.com%26type=my_library%26search_string=Crossover%26search_type=genre</item_song_results_url>
			</item>
			<item>
				<item_type>3</item_type>
				<item_identifier>3kJYG2MA33GkED8t0OxOyDGJV0XSqvXtfrSvto6x</item_identifier>
				<item_media_row>92</item_media_row>
				<item_display_name>Cuban</item_display_name>

				<item_song_results_url>http://www.maestro.fm/maestro_api?api_access_key=KSDFJKCKLJKDLSJFLK34%26user_session_key=mbeWBYP1Ry9eKm4l1K8M%26user_email=dde%40danesc.com%26type=my_library%26search_string=Cuban%26search_type=genre</item_song_results_url>
			</item>
			<item>
				<item_type>3</item_type>
				<item_identifier>mQZv71d9cnRxhDEwqHRZCibm4eSV1bOo1yj9zNIb</item_identifier>
				<item_media_row>93</item_media_row>
				<item_display_name>Cult</item_display_name>

				<item_song_results_url>http://www.maestro.fm/maestro_api?api_access_key=KSDFJKCKLJKDLSJFLK34%26user_session_key=mbeWBYP1Ry9eKm4l1K8M%26user_email=dde%40danesc.com%26type=my_library%26search_string=Cult%26search_type=genre</item_song_results_url>
			</item>
			<item>
				<item_type>3</item_type>
				<item_identifier>pMEnZ4wwMeNZYbJTKwDqyIbDsxBbMCOBYdz8iv54</item_identifier>
				<item_media_row>94</item_media_row>
				<item_display_name>Cumbia</item_display_name>

				<item_song_results_url>http://www.maestro.fm/maestro_api?api_access_key=KSDFJKCKLJKDLSJFLK34%26user_session_key=mbeWBYP1Ry9eKm4l1K8M%26user_email=dde%40danesc.com%26type=my_library%26search_string=Cumbia%26search_type=genre</item_song_results_url>
			</item>
			<item>
				<item_type>3</item_type>
				<item_identifier>l9Kt9FGQe7yQvv8mH8c4LyfvCq1Id3sPDCJMSZn7</item_identifier>
				<item_media_row>95</item_media_row>
				<item_display_name>Dad%27s%20Music</item_display_name>

				<item_song_results_url>http://www.maestro.fm/maestro_api?api_access_key=KSDFJKCKLJKDLSJFLK34%26user_session_key=mbeWBYP1Ry9eKm4l1K8M%26user_email=dde%40danesc.com%26type=my_library%26search_string=Dad%27s%20Music%26search_type=genre</item_song_results_url>
			</item>
			<item>
				<item_type>3</item_type>
				<item_identifier>ZsC0VrRoRvegIvcN3IC9J6lRfOfZCpSmhemDWD1x</item_identifier>
				<item_media_row>96</item_media_row>
				<item_display_name>Dance</item_display_name>

				<item_song_results_url>http://www.maestro.fm/maestro_api?api_access_key=KSDFJKCKLJKDLSJFLK34%26user_session_key=mbeWBYP1Ry9eKm4l1K8M%26user_email=dde%40danesc.com%26type=my_library%26search_string=Dance%26search_type=genre</item_song_results_url>
			</item>
			<item>
				<item_type>3</item_type>
				<item_identifier>Y3LZTqQ9ZITrI4Pi1geoyJeLF6H5Hpgpt1OMroVR</item_identifier>
				<item_media_row>97</item_media_row>
				<item_display_name>Dance%20and%20Electronica</item_display_name>

				<item_song_results_url>http://www.maestro.fm/maestro_api?api_access_key=KSDFJKCKLJKDLSJFLK34%26user_session_key=mbeWBYP1Ry9eKm4l1K8M%26user_email=dde%40danesc.com%26type=my_library%26search_string=Dance%20and%20Electronica%26search_type=genre</item_song_results_url>
			</item>
			<item>
				<item_type>3</item_type>
				<item_identifier>TsFOIXbrantQxQYA1jZEUQKKzU0DE2Ohud5DBg5l</item_identifier>
				<item_media_row>98</item_media_row>
				<item_display_name>Dance%20Hall</item_display_name>

				<item_song_results_url>http://www.maestro.fm/maestro_api?api_access_key=KSDFJKCKLJKDLSJFLK34%26user_session_key=mbeWBYP1Ry9eKm4l1K8M%26user_email=dde%40danesc.com%26type=my_library%26search_string=Dance%20Hall%26search_type=genre</item_song_results_url>
			</item>
			<item>
				<item_type>3</item_type>
				<item_identifier>vXcpsyqkDMCpabwRZAL8FBghfZ7M4yazWCpPBf9P</item_identifier>
				<item_media_row>99</item_media_row>
				<item_display_name>dancehall</item_display_name>

				<item_song_results_url>http://www.maestro.fm/maestro_api?api_access_key=KSDFJKCKLJKDLSJFLK34%26user_session_key=mbeWBYP1Ry9eKm4l1K8M%26user_email=dde%40danesc.com%26type=my_library%26search_string=dancehall%26search_type=genre</item_song_results_url>
			</item>
		</section>
	</response>
</maestro>


Failed XML 

<maestro xmlns:p="http://www.maestro.fm" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	<summary>
		<request_username></request_username>
		<request_date>20090517213137</request_date>
		<request_type>my_library</request_type>
		<total_pages></total_pages>
		<current_page>10</current_page>

		<number_of_results></number_of_results>
		<lines_per_page>10</lines_per_page>
	</summary>
	<response>
		<user_session_key>mbeWBYP1Ry9eKm4l1K8</user_session_key>
		<user_valid>0</user_valid>
 		<user_display>Username and password do not match.</user_display>

	</response>
</maestro>


Back to API Methods

Retrieved from "http://api.maestro.fm/index.php/Library/Genre"
Personal tools