Grab a station. Get some tunes.

API Documentation

account

Parameter Type Values Description
login integer (optional) Login to a user account.

Extra Parameters

username, password
logout integer (optional) Logout of the account.
format string xml, json, php (optional) The format for the output. If php is requested, the output will be returned using Serialized PHP.
jsoncallback string (optional) Callback function when using JSON with Padding (JSONP)
help boolean true (optional) Show this help screen.

album

Parameter Type Values Description
album_id integer (optional) Find album information by Album ID.
format string xml, json, php (optional) The format for the output. If php is requested, the output will be returned using Serialized PHP.
jsoncallback string (optional) Callback function when using JSON with Padding (JSONP)
help boolean true (optional) Show this help screen.

artist

Parameter Type Values Description
artist_id integer (optional) Find artist information by Artist ID.
artist_name string (optional) Search for artist name; a list will be returned for ambiguous names.
station_id integer (optional) Get the top artists in a designated timeframe for a station.
top boolean true (optional) Shows popular artists.
recommendations boolean true (optional) Return recommended artists using the following parameter (artist_id) and any of the optional parameters (negative_artist_id and exclude_artist_id).

Extra Parameters

artist_id, negative_artist_id, exclude_artist_id
limit integer (optional) Number of results to limit search to.
minutes integer (optional) Number of minutes to go back in recent radio history (default is 60, or 1 hour).
format string xml, json, php (optional) The format for the output. If php is requested, the output will be returned using Serialized PHP.
jsoncallback string (optional) Callback function when using JSON with Padding (JSONP)
help boolean true (optional) Show this help screen.

country

Parameter Type Values Description
all string (optional) List all countries that have stations.
limit integer (optional) Number of results to limit search to.
minutes integer (optional) Number of minutes to go back in recent radio history (default is 60, or 1 hour).
format string xml, json, php (optional) The format for the output. If php is requested, the output will be returned using Serialized PHP.
jsoncallback string (optional) Callback function when using JSON with Padding (JSONP)
help boolean true (optional) Show this help screen.

city

Parameter Type Values Description
all string (optional) List all cities that have a station.
country string (optional) List cities for a particular country.
limit integer (optional) Number of results to limit search to.
minutes integer (optional) Number of minutes to go back in recent radio history (default is 60, or 1 hour).
format string xml, json, php (optional) The format for the output. If php is requested, the output will be returned using Serialized PHP.
jsoncallback string (optional) Callback function when using JSON with Padding (JSONP)
help boolean true (optional) Show this help screen.

favorites

Parameter Type Values Description
get string (optional) Get the list of favorites for the current account.
set string (optional) Set the full list of favorites as comma delimited entries for the current account.

Extra Parameters

station_id
format string xml, json, php (optional) The format for the output. If php is requested, the output will be returned using Serialized PHP.
jsoncallback string (optional) Callback function when using JSON with Padding (JSONP)
help boolean true (optional) Show this help screen.

genre

Parameter Type Values Description
top boolean true Shows top genres.
sort string alpha, popularity (optional) Sort options of the resulting list. Will always return the most popular genre names before the alphabetical sort happens.
limit integer (optional) Number of results to limit search to.
format string xml, json, php (optional) The format for the output. If php is requested, the output will be returned using Serialized PHP.
jsoncallback string (optional) Callback function when using JSON with Padding (JSONP)
help boolean true (optional) Show this help screen.

station

Parameter Type Values Description
station_id integer (optional) Find station information by Station ID.
artist_id integer (optional) Find stations by the One Llama Artist ID.
track_id integer (optional) Find stations by the One Llama Track ID.
genre_name string (optional) Find stations by the genre name.
country string (optional) Find stations by country.
city string (optional) Find stations by city.
user_id integer (optional) Get favorites for a user (only available when logged in as that user).
limit integer (optional) Number of results to limit search to.
minutes integer (optional) Number of minutes to go back.
format string xml, json, php (optional) The format for the output. If php is requested, the output will be returned using Serialized PHP.
jsoncallback string (optional) Callback function when using JSON with Padding (JSONP)
help boolean true (optional) Show this help screen.

stream

Parameter Type Values Description
track_id integer (optional) Find track information by Track ID.
limit integer (optional) Number of results to limit search to.
format string xml, json, php (optional) The format for the output. If php is requested, the output will be returned using Serialized PHP.
jsoncallback string (optional) Callback function when using JSON with Padding (JSONP)
help boolean true (optional) Show this help screen.

track

Parameter Type Values Description
track_id integer (optional) Find track information by Track ID.
station_id integer (optional) One Llama Station ID. This ID is provided in other recommendation and search results.
keyword string (optional) Search keyword.
top boolean true (optional) Shows top tracks.
full boolean (optional) Return full list of track information.
limit integer (optional) Number of results to limit search to.
minutes integer (optional) Number of minutes to go back in recent radio history (default is 60, or 1 hour).
format string xml, json, php (optional) The format for the output. If php is requested, the output will be returned using Serialized PHP.
jsoncallback string (optional) Callback function when using JSON with Padding (JSONP)
help boolean true (optional) Show this help screen.
My Favorites
Drag and drop a station to the [+] icon to add it to your list of favorites.