API Version 1.5.6A

Usage of Ella Web Services is based on a REST Architecture which accepts HTTP GET, POST AND PUT requests. Ella works on HTTP and HTTPS protocols. The return format can be XML or HTML (it can also be M3U or XSPF for playlist generation). Ella lite provides the “soundslike” function as the key way to get music recommendations. “Sounds like” takes as input an existing track or artist and returns the top 10 entries from the Ella catalogue which are closest to the seed track.
Play around and find something you like!

Web Service

• Ella-lite functions via a hosted gateway at 3scale.net, that can be accessed at the following URL: http://bmat.3scale.ws/

Status Codes

The status codes are HTTP standard:

• 200: OK
• 400: Bad Request
• 401: Unauthorised
• 404: Not found

Calls and parameters

There is one main function to call:

• Name: soundsLike
• http method: HTTP_GET
• uri: BASE_URL/recommendation/soundslike.xml?
• search_string=‘query’&limit=NUM&offset=NUM&apikey=‘user key’
• parameter – search_string: Artist and track name
• parameter – limit: Number of results to retrieve (optional)
• parameter – offset: Integer Offset value (optional)
• parameter – apikey: String for your contract (e.g. 499d6bc01c3bcfdf5e81fe92e21f3622)
• status codes: 200, 400, 401
• Returns: A list of entities in XML or HTML format, returning the recommended tracks related to the (artist name and track name) query.

Example

• http://bmat.3scale.ws/recommendation/soundslike.xml?user_key=499d6bc01c3bcfdf5e81fe92e21f3622&search_string=u2+one