Maestro.fm

for Developers

Library/Song

From MaestroWikiAPI

Jump to: navigation, search

Library - Song Browse

Returns XML to display the user's library sorted by song 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=title&current_page=0&linesPerPage=10&index_view=0&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 [title] - 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 [0] - This is required to show in list mode 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>20090517214813</request_date>
		<request_type>my_library</request_type>
		<total_pages>3175</total_pages>
		<current_page>1000</current_page>

		<number_of_results>31749</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>vKHjU1hslkTIh3AIXVKitZ6UrHUFnvBjGSSkUAdF</item_identifier>
				<item_media_row>9991</item_media_row>
				<item_display_name>Grievin%27%20and%20Smokin%27</item_display_name>

				<item_status>1</item_status>
				<item_player_play>http://www.maestro.fm/maestro_api?api_access_key=KSDFJKCKLJKDLSJFLK34%26user_session_key=mbeWBYP1Ry9eKm4l1K8M%26user_email=dde%40danesc.com %26type=play_result%26search_string=%26search_type=%26media_key=vKHjU1hslkTIh3AIXVKitZ6UrHUFnvBjGSSkUAdF%26playlist_id=-1%26random=no%26action=current%26media_row=9991</item_player_play>
				<item_artist_name>The%20Gourds</item_artist_name>
				<item_album_name></item_album_name>
				<item_song_name>Grievin%27%20and%20Smokin%27</item_song_name>
				<item_genre_name></item_genre_name>
			</item>

			<item>
				<item_type>3</item_type>
				<item_identifier>aQOhIhT0Zr9Ft9vyzziTrXXCInb9xXbYxzFGhiGH</item_identifier>
				<item_media_row>9992</item_media_row>
				<item_display_name>Gimme%20Some%20Lovin%27</item_display_name>
				<item_status>1</item_status>

				<item_player_play>http://www.maestro.fm/maestro_api?api_access_key=KSDFJKCKLJKDLSJFLK34%26user_session_key=mbeWBYP1Ry9eKm4l1K8M%26user_email=dde%40danesc.com %26type=play_result%26search_string=%26search_type=%26media_key=aQOhIhT0Zr9Ft9vyzziTrXXCInb9xXbYxzFGhiGH%26playlist_id=-1%26random=no%26action=current%26media_row=9992</item_player_play>
				<item_artist_name>The%20Grateful%20Dead</item_artist_name>
				<item_album_name>Dick%27s%20Picks%2C%20Vol.%2021%20Disc%203</item_album_name>
				<item_song_name>Gimme%20Some%20Lovin%27</item_song_name>
				<item_genre_name>Rock</item_genre_name>
			</item>

			<item>
				<item_type>3</item_type>
				<item_identifier>oA95wlBwN86qdOzmNIxiErRPKMbbfzpTAyZ7jl47</item_identifier>
 				<item_media_row>9993</item_media_row>
				<item_display_name>Gloria</item_display_name>
				<item_status>1</item_status>

				<item_player_play>http://www.maestro.fm/maestro_api?api_access_key=KSDFJKCKLJKDLSJFLK34%26user_session_key=mbeWBYP1Ry9eKm4l1K8M%26user_email=dde%40danesc.com %26type=play_result%26search_string=%26search_type=%26media_key=oA95wlBwN86qdOzmNIxiErRPKMbbfzpTAyZ7jl47%26playlist_id=-1%26random=no%26action=current%26media_row=9993</item_player_play>
				<item_artist_name>The%20Grateful%20Dead</item_artist_name>
				<item_album_name>Dick%27s%20Picks%2C%20Vol.%2021%20Disc%203</item_album_name>
				<item_song_name>Gloria</item_song_name>
 				<item_genre_name>Rock</item_genre_name>
			</item>

			<item>
 				<item_type>3</item_type>
				<item_identifier>ilUzGcmOprbnxsOmajTTCG4WYz2hFQbxB6xSjjrZ</item_identifier>
				<item_media_row>9994</item_media_row>
				<item_display_name>Good%20Morning%20Little%20School%20Girl</item_display_name>
				<item_status>1</item_status>

				<item_player_play>http://www.maestro.fm/maestro_api?api_access_key=KSDFJKCKLJKDLSJFLK34%26user_session_key=mbeWBYP1Ry9eKm4l1K8M%26user_email=dde%40danesc.com %26type=play_result%26search_string=%26search_type=%26media_key=ilUzGcmOprbnxsOmajTTCG4WYz2hFQbxB6xSjjrZ%26playlist_id=-1%26random=no%26action=current%26media_row=9994</item_player_play>
				<item_artist_name>The%20Grateful%20Dead</item_artist_name>
				<item_album_name>Dick%27s%20Picks%2C%20Vol.%2022%20Disc%202</item_album_name>
				<item_song_name>Good%20Morning%20Little%20School%20Girl</item_song_name>
				<item_genre_name>Rock</item_genre_name>
			</item>

			<item>
				<item_type>3</item_type>
				<item_identifier>WIcJC3Ee4XdqIyaBjd4GOkzQj2aDXSp3kRNxUbbZ</item_identifier>
				<item_media_row>9995</item_media_row>
				<item_display_name>Goin%27%20Down%20the%20Road%20Feeling%20Bad</item_display_name>
				<item_status>1</item_status>

				<item_player_play>http://www.maestro.fm/maestro_api?api_access_key=KSDFJKCKLJKDLSJFLK34%26user_session_key=mbeWBYP1Ry9eKm4l1K8M%26user_email=dde%40danesc.com %26type=play_result%26search_string=%26search_type=%26media_key=WIcJC3Ee4XdqIyaBjd4GOkzQj2aDXSp3kRNxUbbZ%26playlist_id=-1%26random=no%26action=current%26media_row=9995</item_player_play>
				<item_artist_name>The%20Grateful%20Dead</item_artist_name>
				<item_album_name>Hundred%20Year%20Hall%20Disc%201</item_album_name>
				<item_song_name>Goin%27%20Down%20the%20Road%20Feeling%20Bad</item_song_name>
				<item_genre_name>Rock</item_genre_name>
			</item>
 
			<item>
				<item_type>3</item_type>
				<item_identifier>AvgI9rGgglo1KrhU1d4jtFN1u3o6TkqefWwoODV4</item_identifier>
				<item_media_row>9996</item_media_row>
				<item_display_name>Goin%27%20Down%20the%20Road%20Feeling%20Bad</item_display_name>
				<item_status>1</item_status>

				<item_player_play>http://www.maestro.fm/maestro_api?api_access_key=KSDFJKCKLJKDLSJFLK34%26user_session_key=mbeWBYP1Ry9eKm4l1K8M%26user_email=dde%40danesc.com %26type=play_result%26search_string=%26search_type=%26media_key=AvgI9rGgglo1KrhU1d4jtFN1u3o6TkqefWwoODV4%26playlist_id=-1%26random=no%26action=current%26media_row=9996</item_player_play>
				<item_artist_name>The%20Grateful%20Dead</item_artist_name>
				<item_album_name>One%20From%20the%20Vault%20Disc%202</item_album_name>
				<item_song_name>Goin%27%20Down%20the%20Road%20Feeling%20Bad</item_song_name>
				<item_genre_name>Rock</item_genre_name>
			</item>

			<item>
				<item_type>3</item_type>
				<item_identifier>1xJHGcH2UKWwky6kicZ8kdKAosvp9M1AKKSaxjcS</item_identifier>
				<item_media_row>9997</item_media_row>
				<item_display_name>Gone%20Away</item_display_name>
				<item_status>1</item_status>

				<item_player_play>http://www.maestro.fm/maestro_api?api_access_key=KSDFJKCKLJKDLSJFLK34%26user_session_key=mbeWBYP1Ry9eKm4l1K8M%26user_email=dde%40danesc.com %26type=play_result%26search_string=%26search_type=%26media_key=1xJHGcH2UKWwky6kicZ8kdKAosvp9M1AKKSaxjcS%26playlist_id=-1%26random=no%26action=current%26media_row=9997</item_player_play>
 				<item_artist_name>The%20Offspring</item_artist_name>
				<item_album_name>Ixnay%20On%20The%20Hombre</item_album_name>
				<item_song_name>Gone%20Away</item_song_name>
				<item_genre_name>General%20Punk</item_genre_name>
			</item>

 			<item>
				<item_type>3</item_type>
				<item_identifier>mKLPYQWp66emcoPIklgJr0pQgCo8ITU5oqUMG0BN</item_identifier>
				<item_media_row>9998</item_media_row>
				<item_display_name>Good%20God%20%28Original%20Mix%29</item_display_name>
				<item_status>1</item_status>

				<item_player_play>http://www.maestro.fm/maestro_api?api_access_key=KSDFJKCKLJKDLSJFLK34%26user_session_key=mbeWBYP1Ry9eKm4l1K8M%26user_email=dde%40danesc.com %26type=play_result%26search_string=%26search_type=%26media_key=mKLPYQWp66emcoPIklgJr0pQgCo8ITU5oqUMG0BN%26playlist_id=-1%26random=no%26action=current%26media_row=9998</item_player_play>
				<item_artist_name>The%20Potatoheads</item_artist_name>
				<item_album_name>Pump%20It%20Up%20%28Pump%20It%20up%20Club%20Mix%29</item_album_name>
				<item_song_name>Good%20God%20%28Original%20Mix%29</item_song_name>
				<item_genre_name>Trance</item_genre_name>
			</item>

			<item>
				<item_type>3</item_type>
				<item_identifier>Pxg9dIOcJLO1jscP61918puzpok8MtKlq0uUJI7c</item_identifier>
				<item_media_row>9999</item_media_row>
				<item_display_name>Good%20God%20%28Original%20Mix%29</item_display_name>
				<item_status>1</item_status>

				<item_player_play>http://www.maestro.fm/maestro_api?api_access_key=KSDFJKCKLJKDLSJFLK34%26user_session_key=mbeWBYP1Ry9eKm4l1K8M%26user_email=dde%40danesc.com %26type=play_result%26search_string=%26search_type=%26media_key=Pxg9dIOcJLO1jscP61918puzpok8MtKlq0uUJI7c%26playlist_id=-1%26random=no%26action=current%26media_row=9999</item_player_play>
				<item_artist_name>The%20Potatoheads</item_artist_name>
				<item_album_name>Pump%20It%20Up%20%28Pump%20It%20up%20Club%20Mix%29</item_album_name>
				<item_song_name>Good%20God%20%28Original%20Mix%29</item_song_name>
 				<item_genre_name>Trance</item_genre_name>
			</item>

			<item>
				<item_type>3</item_type>
				<item_identifier>XddBWjQunkmejEwkstFN5z0KT9DZFcQmF4yloPgb</item_identifier>
				<item_media_row>10000</item_media_row>
				<item_display_name>Get%20on%20Top</item_display_name>
				<item_status>1</item_status>
 
				<item_player_play>http://www.maestro.fm/maestro_api?api_access_key=KSDFJKCKLJKDLSJFLK34%26user_session_key=mbeWBYP1Ry9eKm4l1K8M%26user_email=dde%40danesc.com %26type=play_result%26search_string=%26search_type=%26media_key=XddBWjQunkmejEwkstFN5z0KT9DZFcQmF4yloPgb%26playlist_id=-1%26random=no%26action=current%26media_row=10000</item_player_play>
				<item_artist_name>The%20Red%20Hot%20Chili%20Peppers</item_artist_name>
				<item_album_name>Californication</item_album_name>
				<item_song_name>Get%20on%20Top</item_song_name>
				<item_genre_name>Rock</item_genre_name>
			</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/Song"
Personal tools