Similar.getEventsByArtist
From MeeMixWiki
Overview
Search for similar events based on artist name/id according to a given artist name or MeeMix artist ID, using your partner ID and partner key. Similarities are based on musical DNA.
This function has geo support. You can retrieve events recommendation based on user location.
Request
Parameters:
| Required | Name | Type | Description |
|---|---|---|---|
| required | partnerId | string | your assigned partner ID. |
| required | partnerKey | string | your assigned partner key. |
| optional | libId | string | look for tracks based on media library created with lib.create. Send empty libId to use MeeMix library. |
| optional | libArtistId | string | look for tracks based on your local artist id submitted with lib.submitTrack. |
| optional | artistId | string | look for events based on an MeeMix artist ID. |
| optional | artistName | string | look for events based on an artist name. |
| optional | distance | integer | look for events until max distance from locationId or lat/long. |
| optional | locationId | string | look for evenst in this location id. |
| optional | lat | float | look for events in this latitude ( send the longitude as well ) |
| optional | long | float | look for events in this latitude ( send the latitude as well ) |
| optional | count | integer | requested results count ( default 1 ) |
| optional | format | string | A set of rules for the output tracks (e.g. popularity, discovery percentage, pulse etc). Look at Results Format for more information. |
Note: either artistName or artistId or libArtistId must be presented in the request.
Note: use either locationId or latitude and longitude as location search parameter.
REST request example:
http://ws.shadow.meemix.com/mxws/services/mxws/similar.getEventsByArtist?partnerId=1025&partnerKey=68e3f2be79bd73bf472e61c53ae5f72b&artistName=pink%20floyd&count=5&format=fav0|dis100&locationId=609&distance=100
Faults
| Code | Description |
|---|---|
| 1 | Invalid partner ID |
| 2 | Invalid partner key |
| 7 | Artist name not found |
| 8 | Invalid artist ID |
| 17 | Invalid input (either artistId or artistName must be specified in the request) |
For a full faults list and example of soapFault please visit the Faults page.
