API Doc

API Methods

tasteometer.compare

Get a Tasteometer score from two inputs, along with a list of shared artists. If the input is a User some additional information is returned.

e.g. http://ws.audioscrobbler.com/2.0/?method=tasteometer.compare&type1=user&type2=user&value1=joano...

Params

type[1|2] (Required x 2) : 'user' | 'artists'
value[1|2] (Required x 2) : [Last.fm username] | [Comma-separated artist names (max. 100)]
limit (Optional, default = 5) : How many shared artists to display
api_key (Required) : A Last.fm API key.

Auth

This service does not require authentication.

Sample Response

<lfm status="ok">
    <comparison>
        <result>
            <score>0.74</score>
            <artists matches="43">
                <artist>
                    <name>Radiohead</name>
                    <url>http://www.last.fm/music/Radiohead</url>
                    <image size="large">http://userserve-ak.last.fm/serve/160/169665.gif</image>
                    <image size="medium">http://userserve-ak.last.fm/serve/85/169665.gif</image>
                    <image size="small">http://userserve-ak.last.fm/serve/50/169665.gif</image>
                </artist>
                <artist>
                    <name>The Beatles</name>
                    <url>http://www.last.fm/music/The+Beatles</url>
                    <image size="large">http://userserve-ak.last.fm/serve/160/153358.jpg</image>
                    <image size="medium">http://userserve-ak.last.fm/serve/85/153358.jpg</image>
                    <image size="small">http://userserve-ak.last.fm/serve/50/153358.jpg</image>
                </artist>
            </artists>
        </result>
        <input>
            <user>
                <name>jwheare</name>
                <url>http://www.last.fm/user/jwheare/</url>
                <image size="large">http://userserve-ak.last.fm/serve/160/857567.png</image>
                <image size="medium">http://userserve-ak.last.fm/serve/85/857567.png</image>
                <image size="small">http://userserve-ak.last.fm/serve/50/857567.png</image>
            </user>
            <myspace>
                <url>http://www.myspace.com/mcscrobbler</url>
                <image>http://x.myspace.com/images/clear.gif</image>
            </myspace>
        </input>
    </comparison>
</lfm>

Errors

2 : Invalid service - This service does not exist
3 : Invalid Method - No method with that name in this package
4 : Authentication Failed - You do not have permissions to access the service
5 : Invalid format - This service doesn't exist in that format
6 : Invalid parameters - Your request is missing a required parameter
7 : Invalid resource specified
8 : Operation failed - Something else went wrong
9 : Invalid session key - Please re-authenticate
10 : Invalid API key - You must be granted a valid key by last.fm
11 : Service Offline - This service is temporarily offline. Try again later.
13 : Invalid method signature supplied
16 : There was a temporary error processing your request. Please try again
26 : Suspended API key - Access for your account has been suspended, please contact Last.fm
29 : Rate limit exceeded - Your IP has made too many requests in a short period