Last.fm API

https://www.last.fm/api/
Admin
Last.fm API allows developers to build applications using Last.fm's music database, providing access...
Tokens:45,171
Snippets:408
Trust Score:10
Update:1 month ago
Show doc for...
Tokens:
Raw
### User Radio Station Examples

Source: https://www.last.fm/api/radio

Examples of constructing station URLs for user-based radio stations.

```text
lastfm://user/last.hq/personal
```

```text
lastfm://user/last.hq/loved
```

```text
lastfm://user/last.hq/recommended
```

```text
lastfm://user/last.hq/neighbours
```

--------------------------------

### Perform GET request to Last.fm API

Source: https://www.last.fm/api/rest

Example of a standard GET request to the API root with required method and api_key parameters.

```text
http://ws.audioscrobbler.com/2.0/?method=artist.getSimilar&api_key=xxx...
```

--------------------------------

### Tag Radio Station Example

Source: https://www.last.fm/api/radio

Example of constructing a station URL for tag-based radio stations.

```text
lastfm://globaltags/disco
```

--------------------------------

### Artist Radio Station Examples

Source: https://www.last.fm/api/radio

Examples of constructing station URLs for artist-based radio stations.

```text
lastfm://artist/cher/similarartists
```

```text
lastfm://artist/cher/fans
```

--------------------------------

### Original XML response example

Source: https://www.last.fm/api/rest

The source XML structure corresponding to the JSON success response example.

```xml
<?xml version="1.0" encoding="utf-8"?>
<lfm status="ok">
 <results for="disco" xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/">
    <opensearch:Query role="request" searchTerms="disco" startPage="1" />
    <opensearch:totalResults>2641</opensearch:totalResults>
    <opensearch:startIndex>0</opensearch:startIndex>
    <opensearch:itemsPerPage>20</opensearch:itemsPerPage>
    <tagmatches>
      <tag>
        <name>disco</name>
        <count>55483</count>
        <url>www.last.fm/tag/disco</url>
      </tag>
      ...
      <tag>
        <name>disco pop</name>
        <count>160</count>
        <url>www.last.fm/tag/disco%20pop</url>
      </tag>
    </tagmatches>
  </results>
</lfm>
```

--------------------------------

### XSPF Playlist Format Example

Source: https://www.last.fm/api/radio

An example of the XSPF (XML Shareable Playlist Format) structure returned by the radio.getPlaylist API method. This format contains track information and metadata.

```xml
<playlist version="1" xmlns="http://xspf.org/ns/0/">
     <title>+Cher+Similar+Artists</title>
     <creator>Last.fm</creator>
     <date>2007-11-26T17:34:38</date>
     <link rel="http://www.last.fm/expiry">3600</link>
     <trackList>
      <track>
       <location>http://play.last.fm/....mp3</location>
       <title>Two People (Live)</title>
       <identifier>8212510</identifier>
       <album>Tina Live In Europe</album>
       <creator>Tina Turner</creator>
       <duration>265000</duration>
       <image>http://images.amazon.com/images/...</image>
       <extension application="http://www.last.fm/">
        <trackauth>12345</trackauth>
        <artistpage>http://www.last.fm/music/Tina+Turner</artistpage>
        <albumpage>http://www.last.fm/music/...</albumpage>
        <trackpage>http://www.last.fm/music/...</trackpage>
        <buyTrackURL>...</buyTrackURL>
        <buyAlbumURL/>
        <freeTrackURL>
        </extension>
      </track>
      <track>
       ...
            

```

--------------------------------

### JSON success response example

Source: https://www.last.fm/api/rest

Example of a successful API response converted to JSON format.

```json
{
"results": {
    "tagmatches": {
      "tag": [{
        "name": "disco",
        "count": "55483",
        "url": "www.last.fm\/tag\/disco"
      },
      ...
      {
        "name": "disco pop",
        "count": "160",
        "url": "www.last.fm\/tag\/disco%20pop"
      }]
    },
    "for": "disco"
  }
}
```

--------------------------------

### Sample XML Response

Source: https://www.last.fm/api/show/user.getRecentTracks

An example of the XML structure returned by the user.getRecentTracks method.

```xml
<recenttracks user="RJ" page="1" perPage="10" totalPages="3019">
  <track nowplaying="true">
    <artist mbid="2f9ecbed-27be-40e6-abca-6de49d50299e">Aretha Franklin</artist>
    <name>Sisters Are Doing It For Themselves</name>
    <mbid/>
    <album mbid=""/>
    <url>www.last.fm/music/Aretha+Franklin/_/Sisters+Are+Doing+It+For+Themselves</url>
    <date uts="1213031819">9 Jun 2008, 17:16</date>
    <streamable>1</streamable>
  </track>
  ...
</recenttracks>
```

--------------------------------

### Sample XML Response

Source: https://www.last.fm/api/show/artist.search

An example of the XML response structure returned by the artist.search method.

```xml
<results for="cher" xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/">
  <opensearch:Query role="request" searchTerms="cher" startPage="1"/>
  <opensearch:totalResults>386</opensearch:totalResults>
  <opensearch:startIndex>0</opensearch:startIndex>
  <opensearch:itemsPerPage>20</opensearch:itemsPerPage>
  <artistmatches>
    <artist>
      <name>Cher</name>
      <mbid>bfcc6d75-a6a5-4bc6-8282-47aec8531818</mbid>
      <url>www.last.fm/music/Cher</url>
      <image_small>http://userserve-ak.last.fm/serve/50/342437.jpg</image_small>
      <image>http://userserve-ak.last.fm/serve/160/342437.jpg</image>
      <streamable>1</streamable>
    </artist>
	...
  </artistmatches>
</results>
```

--------------------------------

### GET /2.0/?method=album.getinfo

Source: https://www.last.fm/api/show/album.getInfo

Fetches album metadata and tracklist information.

```APIDOC
## GET /2.0/?method=album.getinfo

### Description
Get the metadata and tracklist for an album on Last.fm using the album name or a musicbrainz id.

### Method
GET

### Endpoint
/2.0/?method=album.getinfo

### Parameters
#### Query Parameters
- **artist** (string) - Required (unless mbid) - The artist name
- **album** (string) - Required (unless mbid) - The album name
- **mbid** (string) - Optional - The musicbrainz id for the album
- **autocorrect** (integer) - Optional - Transform misspelled artist names into correct artist names (0 or 1)
- **username** (string) - Optional - The username for the context of the request
- **lang** (string) - Optional - The language to return the biography in (ISO 639 alpha-2 code)
- **api_key** (string) - Required - A Last.fm API key

### Response
#### Success Response (200)
- **album** (object) - Contains album details including name, artist, id, mbid, url, releasedate, images, listeners, playcount, toptags, and tracks.
```

--------------------------------

### GET /api/auth/

Source: https://www.last.fm/api/authspec

Redirects the user to the Last.fm authorization page to grant permission to your application.

```APIDOC
## GET /api/auth/

### Description
Redirects the user to the Last.fm authentication page. If the user is not logged in, they will be prompted to log in and grant permission to your application.

### Method
GET

### Endpoint
http://www.last.fm/api/auth/

### Parameters
#### Query Parameters
- **api_key** (string) - Required - Your 32-character API Key.
```

--------------------------------

### GET /2.0/?method=artist.getsimilar

Source: https://www.last.fm/api/show/artist.getSimilar

Retrieves a list of artists similar to the specified artist.

```APIDOC
## GET /2.0/?method=artist.getsimilar

### Description
Get all the artists similar to this artist.

### Method
GET

### Endpoint
/2.0/?method=artist.getsimilar

### Parameters
#### Query Parameters
- **artist** (string) - Required (unless mbid) - The artist name
- **mbid** (string) - Optional - The musicbrainz id for the artist
- **limit** (integer) - Optional - Limit the number of similar artists returned
- **autocorrect** (0|1) - Optional - Transform misspelled artist names into correct artist names
- **api_key** (string) - Required - A Last.fm API key

### Response
#### Success Response (200)
- **similarartists** (object) - A list of similar artists with their details including name, mbid, match score, url, and images.
```

--------------------------------

### Sample XML Response for user.getInfo

Source: https://www.last.fm/api/show/user.getInfo

The response returns user profile data in XML format, including fields like id, name, and playcount.

```xml
<user>
    <id>1000002</id>
    <name>RJ</name>
    <realname>Richard Jones </realname>
    <url>http://www.last.fm/user/RJ</url>
    <image>http://userserve-ak.last.fm/serve/126/8270359.jpg</image>
    <country>UK</country>
    <age>27</age>
    <gender>m</gender>
    <subscriber>1</subscriber>
    <playcount>54189</playcount>
    <playlists>4</playlists>
    <bootstrap>0</bootstrap>
    <registered unixtime="1037793040">2002-11-20 11:50</registered>
</user>
```

--------------------------------

### Construct API Method Signature String

Source: https://www.last.fm/api/mobileauth

Example of the parameter concatenation scheme using the <name><value> format.

```text
**api_key**xxxxxxxx**method**auth.getMobileSession**password**xxxxxxx**username**xxxxxxxx
```

--------------------------------

### Sample XML Response for auth.getMobileSession

Source: https://www.last.fm/api/show/auth.getMobileSession

Example of the XML structure returned upon a successful authentication request.

```xml
<lfm status="ok">
  <session>
    <name>MyLastFMUsername</name>
    <key>d580d57f32848f5dcf574d1ce18d78b2</key>
    <subscriber>0</subscriber>
  </session>
</lfm>
```

--------------------------------

### Request User Authorization via HTTP GET

Source: https://www.last.fm/api/desktopauth

Construct an HTTP GET request to redirect the user to the Last.fm authorization page using your API key and the obtained token.

```http
http://www.last.fm/api/auth/?api_key=xxxxxxxxxxx&token=xxxxxxxx
```

--------------------------------

### Sample Response for album.addTags

Source: https://www.last.fm/api/show/album.addTags

The expected XML response format upon a successful tag addition.

```xml
<lfm status="ok">
</lfm>
```

--------------------------------

### GET /2.0/?method=track.gettoptags

Source: https://www.last.fm/api/show/track.getTopTags

Retrieves the top tags for a track.

```APIDOC
## GET /2.0/?method=track.gettoptags

### Description
Get the top tags for this track on Last.fm, ordered by tag count. Supply either track & artist name or mbid.

### Method
GET

### Endpoint
/2.0/?method=track.gettoptags

### Parameters
#### Query Parameters
- **track** (string) - Required (unless mbid) - The track name
- **artist** (string) - Required (unless mbid) - The artist name
- **mbid** (string) - Optional - The musicbrainz id for the track
- **autocorrect** (integer) - Optional - Transform misspelled artist and track names into correct artist and track names
- **api_key** (string) - Required - A Last.fm API key

### Response
#### Success Response (200)
- **toptags** (object) - Contains a list of tags with name, count, and url.

### Errors
- **2**: Invalid service
- **3**: Invalid Method
- **4**: Authentication Failed
- **5**: Invalid format
- **6**: Invalid parameters
- **7**: Invalid resource specified
- **8**: Operation failed
- **9**: Invalid session key
- **10**: Invalid API key
- **11**: Service Offline
- **13**: Invalid method signature supplied
- **16**: Temporary error
- **26**: Suspended API key
- **29**: Rate limit exceeded
```

--------------------------------

### Sample XML Response for album.getTags

Source: https://www.last.fm/api/show/album.getTags

Example of the XML structure returned by the API when querying tags for an album.

```xml
<tags artist="Sally Shapiro" album="Disco Romance">
  <tag>
    <name>swedish</name>
    <url>http://www.last.fm/tag/swedish</url>
  </tag>
  ...
</tags>
```

--------------------------------

### GET tag.getTopTracks

Source: https://www.last.fm/api/show/tag.getTopTracks

Retrieves the top tracks for a specified tag.

```APIDOC
## GET /2.0/?method=tag.gettoptracks

### Description
Get the top tracks tagged by this tag, ordered by tag count.

### Method
GET

### Endpoint
/2.0/?method=tag.gettoptracks

### Parameters
#### Query Parameters
- **tag** (string) - Required - The tag name
- **api_key** (string) - Required - A Last.fm API key
- **limit** (integer) - Optional - The number of results to fetch per page. Defaults to 50.
- **page** (integer) - Optional - The page number to fetch. Defaults to first page.
- **format** (string) - Optional - The response format (e.g., json)

### Response
#### Success Response (200)
- **toptracks** (object) - Contains the list of tracks associated with the tag.

### Errors
- **2**: Invalid service
- **3**: Invalid Method
- **4**: Authentication Failed
- **5**: Invalid format
- **6**: Invalid parameters
- **7**: Invalid resource specified
- **8**: Operation failed
- **9**: Invalid session key
- **10**: Invalid API key
- **11**: Service Offline
- **13**: Invalid method signature supplied
- **16**: Temporary error
- **26**: Suspended API key
- **29**: Rate limit exceeded
```

--------------------------------

### GET /2.0/?method=tag.getinfo

Source: https://www.last.fm/api/show/tag.getInfo

Retrieves metadata for a specified tag.

```APIDOC
## GET /2.0/?method=tag.getinfo

### Description
Get the metadata for a tag.

### Method
GET

### Endpoint
/2.0/?method=tag.getinfo

### Parameters
#### Query Parameters
- **tag** (string) - Required - The tag name
- **api_key** (string) - Required - A Last.fm API key
- **lang** (string) - Optional - The language to return the wiki in, expressed as an ISO 639 alpha-2 code

### Response
#### Success Response (200)
- **name** (string) - The name of the tag
- **url** (string) - The URL for the tag on Last.fm
- **reach** (integer) - The number of users that have used this tag
- **taggings** (integer) - The total number of times this tag has been used
- **streamable** (integer) - A value of '1' indicates this tag can be used as a radio station
- **wiki** (object) - Contains published date, summary, and content

### Errors
- **2**: Invalid service
- **3**: Invalid Method
- **4**: Authentication Failed
- **5**: Invalid format
- **6**: Invalid parameters
- **7**: Invalid resource specified
- **8**: Operation failed
- **9**: Invalid session key
- **10**: Invalid API key
- **11**: Service Offline
- **13**: Invalid method signature supplied
- **16**: Temporary error processing request
- **26**: Suspended API key
- **29**: Rate limit exceeded
```

--------------------------------

### Sample XML Response for user.getPersonalTags

Source: https://www.last.fm/api/show/user.getPersonalTags

Example of the XML structure returned when querying personal tags for a user.

```xml
<taggings user="RJ" tag="rock" page="1" perPage="50" totalPages="1" total="11">
  <artists>
    <artist>
      <name>John Hammond</name>
      <mbid>d83e599c-2d5a-44ec-b727-587e1455b1b5</mbid>
      <url>http://www.last.fm/music/John+Hammond</url>
      <streamable>1</streamable>
      <image size="small">http://userserve-ak.last.fm/serve/34/255418.jpg</image>
      <image size="medium">http://userserve-ak.last.fm/serve/64/255418.jpg</image>
      <image size="large">http://userserve-ak.last.fm/serve/126/255418.jpg</image>
      <image size="extralarge">http://userserve-ak.last.fm/serve/252/255418.jpg</image>
      <image size="mega">http://userserve-ak.last.fm/serve/_/255418/John+Hammond.jpg</image>
    </artist>
  </artists>
</taggings>
```

--------------------------------

### Example API Request URLs

Source: https://www.last.fm/api/show/user.getWeeklyChartList

URLs for requesting weekly chart lists in JSON and XML formats.

```text
/2.0/?method=user.getweeklychartlist&user=rj&api_key=YOUR_API_KEY&format=json
```

```text
/2.0/?method=user.getweeklychartlist&user=rj&api_key=YOUR_API_KEY
```

--------------------------------

### GET /2.0/?method=chart.gettoptracks

Source: https://www.last.fm/api/show/chart.getTopTracks

Retrieves the top tracks chart.

```APIDOC
## GET /2.0/?method=chart.gettoptracks

### Description
Get the top tracks chart.

### Method
GET

### Endpoint
/2.0/?method=chart.gettoptracks

### Parameters
#### Query Parameters
- **page** (Optional) - The page number to fetch. Defaults to first page.
- **limit** (Optional) - The number of results to fetch per page. Defaults to 50.
- **api_key** (Required) - A Last.fm API key.

### Response
#### Success Response (200)
- **tracks** (XML/JSON) - A list of tracks with details including name, playcount, listeners, and artist information.
```

--------------------------------

### GET /2.0/?method=chart.gettopartists

Source: https://www.last.fm/api/show/chart.getTopArtists

Retrieves the top artists chart.

```APIDOC
## GET /2.0/?method=chart.gettopartists

### Description
Get the top artists chart.

### Method
GET

### Endpoint
/2.0/?method=chart.gettopartists

### Parameters
#### Query Parameters
- **api_key** (string) - Required - A Last.fm API key.
- **page** (integer) - Optional - The page number to fetch. Defaults to first page.
- **limit** (integer) - Optional - The number of results to fetch per page. Defaults to 50.
- **format** (string) - Optional - The response format (e.g., json).

### Response
#### Success Response (200)
- **artists** (object) - The list of top artists.

#### Response Example
<artists page="1" perPage="50" totalPages="20" total="1000">
  <artist>
    <name>The Beatles</name>
    <playcount>1550293</playcount>
    <listeners>114106</listeners>
    <mbid>b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d</mbid>
    <url>http://www.last.fm/music/The+Beatles</url>
    <streamable>1</streamable>
    <image size="small">http://userserve-ak.last.fm/serve/34/880929.jpg</image>
    <image size="medium">http://userserve-ak.last.fm/serve/64/880929.jpg</image>
    <image size="large">http://userserve-ak.last.fm/serve/126/880929.jpg</image>
    <image size="extralarge">http://userserve-ak.last.fm/serve/252/880929.jpg</image>
    <image size="mega">http://userserve-ak.last.fm/serve/500/880929/The+Beatles.jpg</image>
  </artist>
</artists>
```

--------------------------------

### Sample XML Response for user.getTopTags

Source: https://www.last.fm/api/show/user.getTopTags

The response structure for a successful request, showing the tag name, usage count, and associated URL.

```xml
<toptags user="RJ">
  <tag>
    <name>rock</name>
    <count>12</count>
    <url>www.last.fm/tag/rock</url>
  </tag>
  ...
</toptags>
```

--------------------------------

### track.updateNowPlaying

Source: https://www.last.fm/api/scrobbling

Lets a client notify Last.fm that a user has started listening to a track. This is optional but recommended and should be sent as soon as a user starts listening to a track. Requests must be sent as HTTP POST requests to http://ws.audioscrobbler.com/2.0/ with form urlencoded parameters in the body and must be authenticated.

```APIDOC
## track.updateNowPlaying

### Description
Sends "Now Playing" information to Last.fm, indicating the track a user is currently listening to. This updates the user's profile but does not affect charts. It's recommended to send this request as soon as a track begins playing.

### Method
POST

### Endpoint
http://ws.audioscrobbler.com/2.0/

### Parameters
#### Request Body
- **track** (string) - Required - The title of the track.
- **artist** (string) - Required - The name of the artist.
- **album** (string) - Optional - The name of the album.
- **duration** (integer) - Optional - The duration of the track in seconds.
- **chosenByUser** (boolean) - Optional - Indicates if the scrobble was directly chosen by the user (defaults to true).
- **api_key** (string) - Required - Your Last.fm API key.
- **sk** (string) - Required - A session key for authentication.

### Request Example
```
POST http://ws.audioscrobbler.com/2.0/
Content-Type: application/x-www-form-urlencoded

track=Hey+Jude&artist=The+Beatles&album=Let+It+Be&duration=431&api_key=YOUR_API_KEY&sk=YOUR_SESSION_KEY
```

### Response
#### Success Response (200)
- **lfm status** (string) - "ok"

#### Response Example
```json
{
  "nowplaying": {
    "track": {"#text": "Hey Jude", "#attributes": {"artist": "The Beatles", "album": "Let It Be"}},
    "artist": {"#text": "The Beatles", "#attributes": {"mbid": "..."}},
    "album": {"#text": "Let It Be", "#attributes": {"mbid": "..."}},
    "duration": "431",
    "user": "username",
    "@attr": {"nowplaying": "true"}
  }
}
```

### Error Handling
- **HTTP Status Code**: Indicates general request success or failure.
- **lfm status attribute**: "ok" or "failed".
- **lfm error code**: Provides specific error details when status is "failed".
```

--------------------------------

### Sample XML Response for tag.getTopTags

Source: https://www.last.fm/api/show/tag.getTopTags

The response returns a list of tags with their name, usage count, and URL.

```xml
<toptags>
  <tag>
    <name>rock</name>
    <count>1994155</count>
    <url>www.last.fm/tag/rock</url>
  </tag>
  ...
</toptags>
```

--------------------------------

### Retrieve Album Metadata via XML

Source: https://www.last.fm/api/show/album.getInfo

Example of the XML response structure returned by the album.getInfo method.

```xml
<album>
  <name>Believe</name>
  <artist>Cher</artist>
  <id>2026126</id>
  <mbid>61bf0388-b8a9-48f4-81d1-7eb02706dfb0</mbid>
  <url>http://www.last.fm/music/Cher/Believe</url>
  <releasedate>6 Apr 1999, 00:00</releasedate>
  <image size="small">...</image>
  <image size="medium">...</image>
  <image size="large">...</image>
  <listeners>47602</listeners>
  <playcount>212991</playcount>
  <toptags>
    <tag>
      <name>pop</name>
      <url>http://www.last.fm/tag/pop</url>
    </tag>
    ...
  </toptags>
  <tracks>
    <track rank="1">
      <name>Believe</name>
      <duration>239</duration>
      <mbid/>
      <url>http://www.last.fm/music/Cher/_/Believe</url>
      <streamable fulltrack="0">1</streamable>
      <artist>
        <name>Cher</name>
        <mbid>bfcc6d75-a6a5-4bc6-8282-47aec8531818</mbid>
        <url>http://www.last.fm/music/Cher</url>
      </artist>
    </track>
    ...
  </tracks>
</album>
```

--------------------------------

### GET user.getWeeklyTrackChart

Source: https://www.last.fm/api/show/user.getWeeklyTrackChart

Retrieves a weekly track chart for a user profile.

```APIDOC
## GET /2.0/?method=user.getweeklytrackchart

### Description
Get a track chart for a user profile, for a given date range. If no date range is supplied, it will return the most recent track chart for this user.

### Method
GET

### Parameters
#### Query Parameters
- **user** (string) - Required - The last.fm username to fetch the charts of.
- **from** (string) - Optional - The date at which the chart should start from.
- **to** (string) - Optional - The date at which the chart should end on.
- **api_key** (string) - Required - A Last.fm API key.

### Response
#### Success Response (200)
- **weeklytrackchart** (object) - Contains the track chart data including user, from, to, and a list of tracks.

### Errors
- **2**: Invalid service
- **3**: Invalid Method
- **4**: Authentication Failed
- **5**: Invalid format
- **6**: Invalid parameters
- **7**: Invalid resource specified
- **8**: Operation failed
- **9**: Invalid session key
- **10**: Invalid API key
- **11**: Service Offline
- **13**: Invalid method signature supplied
- **16**: Temporary error
- **26**: Suspended API key
- **29**: Rate limit exceeded
```

--------------------------------

### GET /2.0/?method=user.gettoptags

Source: https://www.last.fm/api/show/user.getTopTags

Retrieves the top tags for a specified user.

```APIDOC
## GET /2.0/?method=user.gettoptags

### Description
Get the top tags used by this user.

### Method
GET

### Endpoint
/2.0/?method=user.gettoptags

### Parameters
#### Query Parameters
- **user** (string) - Required - The user name
- **limit** (integer) - Optional - Limit the number of tags returned
- **api_key** (string) - Required - A Last.fm API key

### Response
#### Success Response (200)
- **toptags** (object) - Contains a list of tag elements with name, count, and url.

#### Response Example
<toptags user="RJ">
  <tag>
    <name>rock</name>
    <count>12</count>
    <url>www.last.fm/tag/rock</url>
  </tag>
</toptags>
```

--------------------------------

### GET track.getTags

Source: https://www.last.fm/api/show/track.getTags

Retrieves the tags applied by an individual user to a track.

```APIDOC
## GET /2.0/?method=track.getTags

### Description
Get the tags applied by an individual user to a track on Last.fm.

### Method
GET

### Endpoint
/2.0/?method=track.getTags

### Parameters
#### Query Parameters
- **artist** (string) - Required (unless mbid) - The artist name
- **track** (string) - Required (unless mbid) - The track name
- **mbid** (string) - Optional - The musicbrainz id for the track
- **autocorrect** (0|1) - Optional - Transform misspelled artist and track names into correct versions
- **user** (string) - Optional - The user to look up (required if not authenticated)
- **api_key** (string) - Required - A Last.fm API key

### Response
#### Success Response (200)
- **tags** (XML/JSON) - A list of tags applied to the track by the user

#### Response Example
<tags artist="Sally Shapiro" track="I'll be by your side">
  <tag>
    <name>swedish</name>
    <url>http://www.last.fm/tag/swedish</url>
  </tag>
</tags>
```

--------------------------------

### Send XML-RPC Request

Source: https://www.last.fm/api/xmlrpc

Example of a methodCall structure for the user.gettoptags method, including user and api_key parameters.

```xml
<methodCall>
 <methodName>user.gettoptags</methodName>
 <params>
  <param>
   <value>
    <struct>
     <member>
      <name>user</name>
      <value>
       <string>joanofarctan</string>
      </value>
     </member>
     <member>
      <name>api_key</name>
      <value>
       <string>b25b959554ed76058ac220b7b2e0a026</string>
      </value>
     </member>
    </struct>
   </value>
  </param>
 </params>
</methodCall>
```

--------------------------------

### GET tag.getTopArtists

Source: https://www.last.fm/api/show/tag.getTopArtists

Retrieves the top artists tagged by a specific tag.

```APIDOC
## GET /2.0/?method=tag.gettopartists

### Description
Get the top artists tagged by this tag, ordered by tag count.

### Method
GET

### Endpoint
/2.0/?method=tag.gettopartists

### Parameters
#### Query Parameters
- **tag** (string) - Required - The tag name
- **api_key** (string) - Required - A Last.fm API key
- **limit** (integer) - Optional - The number of results to fetch per page. Defaults to 50.
- **page** (integer) - Optional - The page number to fetch. Defaults to first page.

### Response
#### Success Response (200)
- **topartists** (object) - Contains a list of artists ranked by the tag.

#### Response Example
<topartists tag="Disco">
  <artist rank="">
    <name>ABBA</name>
    <mbid>d87e52c5-bb8d-4da8-b941-9f4928627dc8</mbid>
    <url>http://www.last.fm/music/ABBA</url>
    <streamable>1</streamable>
    <image size="small">...</image>
    <image size="medium">...</image>
    <image size="large">...</image>
  </artist>
</topartists>
```

--------------------------------

### Sample XML Response for artist.getSimilar

Source: https://www.last.fm/api/show/artist.getSimilar

The response returns a list of similar artists with their names, MBIDs, match scores, URLs, and image assets.

```xml
<similarartists artist="Cher">
  <artist>
    <name>Sonny & Cher</name>
    <mbid>3d6e4b6d-2700-458c-9722-9021965a8164</mbid>
    <match>1</match>
    <url>www.last.fm/music/Sonny%2B%2526%2BCher</url>
    <image size="small">http://userserve-ak.last.fm/serve/34/71168880.png</image>
    <image size="medium">http://userserve-ak.last.fm/serve/64/71168880.png</image>
    <image size="large">http://userserve-ak.last.fm/serve/126/71168880.png</image>
    <image size="extralarge">http://userserve-ak.last.fm/serve/252/71168880.png</image>
    <image size="mega">http://userserve-ak.last.fm/serve/500/71168880/Sonny++Cher.png</image>
    <streamable>1</streamable>
  </artist>
  ...
</similarartists>
```

--------------------------------

### GET /2.0/?method=tag.gettopalbums

Source: https://www.last.fm/api/show/tag.getTopAlbums

Retrieves the top albums for a specified tag.

```APIDOC
## GET /2.0/?method=tag.gettopalbums

### Description
Get the top albums tagged by this tag, ordered by tag count.

### Method
GET

### Endpoint
/2.0/

### Parameters
#### Query Parameters
- **method** (string) - Required - The API method: tag.gettopalbums
- **tag** (string) - Required - The tag name
- **limit** (integer) - Optional - The number of results to fetch per page. Defaults to 50.
- **page** (integer) - Optional - The page number to fetch. Defaults to first page.
- **api_key** (string) - Required - A Last.fm API key.
- **format** (string) - Optional - The response format (json or xml).

### Response
#### Success Response (200)
- **topalbums** (object) - Contains the list of albums associated with the tag.

#### Response Example
<topalbums tag="Disco">
  <album rank="">
    <name>Overpowered</name>
    <mbid/>
    <url>http://www.last.fm/music/Róisín+Murphy/Overpowered</url>
    <artist>
      <name>Róisín Murphy</name>
      <mbid>4c56405d-ba8e-4283-99c3-1dc95bdd50e7</mbid>
      <url>http://www.last.fm/music/Róisín+Murphy</url>
    </artist>
    <image size="small">...</image>
    <image size="medium">...</image>
    <image size="large">...</image>
  </album>
</topalbums>
```

--------------------------------

### Sample XML Response for artist.getInfo

Source: https://www.last.fm/api/show/artist.getInfo

Represents the structure of the XML response returned by the API, containing artist metadata, statistics, similar artists, tags, and biography.

```xml
<artist>
  <name>Cher</name>
  <mbid>bfcc6d75-a6a5-4bc6-8282-47aec8531818</mbid>
  <url>http://www.last.fm/music/Cher</url>
  <image size="small">http://userserve-ak.last.fm/serve/50/285717.jpg</image>
  <image size="medium">http://userserve-ak.last.fm/serve/85/285717.jpg</image>
  <image size="large">http://userserve-ak.last.fm/serve/160/285717.jpg</image>
  <streamable>1</streamable>
  <stats>
    <listeners>196440</listeners>
    <plays>1599101</plays>
  </stats>
  <similar>
    <artist>
      <name>Madonna</name>
      <url>http://www.last.fm/music/Madonna</url>
      <image size="small">http://userserve-ak.last.fm/serve/50/5112299.jpg</image>
      <image size="medium">http://userserve-ak.last.fm/serve/85/5112299.jpg></image>
      <image size="large">http://userserve-ak.last.fm/serve/160/5112299.jpg</image>
    </artist>
    ...
  </similar>
  <tags>
    <tag>
      <name>pop</name>
      <url>http://www.last.fm/tag/pop</url>
    </tag>
    ...
  </tags>
  <bio>
    <published>Thu, 13 Mar 2008 03:59:18 +0000</published>
    <summary>...</summary>
    <content>...</content>
  </bio>
</artist>
```

--------------------------------

### GET /2.0/?method=artist.gettoptags

Source: https://www.last.fm/api/show/artist.getTopTags

Retrieves the top tags for a specified artist.

```APIDOC
## GET /2.0/?method=artist.gettoptags

### Description
Get the top tags for an artist on Last.fm, ordered by popularity.

### Method
GET

### Endpoint
/2.0/?method=artist.gettoptags

### Parameters
#### Query Parameters
- **artist** (string) - Required (unless mbid) - The artist name
- **mbid** (string) - Optional - The musicbrainz id for the artist
- **autocorrect** (0|1) - Optional - Transform misspelled artist names into correct artist names
- **api_key** (string) - Required - A Last.fm API key

### Response
#### Success Response (200)
- **toptags** (object) - Contains a list of tags for the artist

#### Response Example
<toptags artist="Cher">
  <tag>
    <name>pop</name>
    <url>http://www.last.fm/tag/pop</url>
  </tag>
</toptags>
```

--------------------------------

### GET /2.0/?method=artist.gettopalbums

Source: https://www.last.fm/api/show/artist.getTopAlbums

Retrieves the top albums for an artist on Last.fm.

```APIDOC
## GET /2.0/?method=artist.gettopalbums

### Description
Get the top albums for an artist on Last.fm, ordered by popularity.

### Method
GET

### Endpoint
/2.0/

### Parameters
#### Query Parameters
- **method** (string) - Required - The API method: artist.gettopalbums
- **artist** (string) - Required (unless mbid) - The artist name
- **mbid** (string) - Optional - The musicbrainz id for the artist
- **autocorrect** (integer) - Optional - Transform misspelled artist names into correct artist names (0 or 1)
- **page** (integer) - Optional - The page number to fetch
- **limit** (integer) - Optional - The number of results to fetch per page
- **api_key** (string) - Required - A Last.fm API key
- **format** (string) - Optional - The response format (json or xml)

### Response
#### Success Response (200)
- **topalbums** (object) - The container for the list of albums
- **album** (array) - List of album objects containing name, mbid, listeners, url, and images

#### Response Example
<topalbums artist="Cher">
  <album rank="1">
    <name>Believe</name>
    <mbid>61bf0388-b8a9-48f4-81d1-7eb02706dfb0</mbid>
    <listeners>24486</listeners>
    <url>http://www.last.fm/music/Cher/Believe</url>
    <image size="small">...</image>
    <image size=" medium">...</image>
    <image size="large">...</image>
  </album>
</topalbums>
```

--------------------------------

### Sample XML Response for artist.getTopTags

Source: https://www.last.fm/api/show/artist.getTopTags

The response returns a list of tags, each containing the tag name and its corresponding Last.fm URL.

```xml
<toptags artist="Cher">
  <tag>
    <name>pop</name>
    <url>http://www.last.fm/tag/pop</url>
  </tag>
  ...
</toptags>
```

--------------------------------

### Sample XML Response for artist.getTopTracks

Source: https://www.last.fm/api/show/artist.getTopTracks

The response structure for a successful request, showing track details like name, playcount, and listeners.

```xml
<toptracks artist="Cher">
  <track rank="1">
    <name>Believe</name>
    <mbid/>
    <playcount>56325</playcount>
    <listeners>23217</listeners>
    <url>http://www.last.fm/music/Cher/_/Believe</url>
    <image size="small">...</image>
    <image size=" medium">...</image>
    <image size="large">...</image>
  </track>
  ...
</toptracks>
```

--------------------------------

### GET /2.0/?method=user.getweeklyartistchart

Source: https://www.last.fm/api/show/user.getWeeklyArtistChart

Retrieves the weekly artist chart for a given user.

```APIDOC
## GET /2.0/?method=user.getweeklyartistchart

### Description
Get an artist chart for a user profile, for a given date range. If no date range is supplied, it will return the most recent artist chart for this user.

### Method
GET

### Endpoint
/2.0/

### Parameters
#### Query Parameters
- **method** (string) - Required - The API method: user.getweeklyartistchart
- **user** (string) - Required - The last.fm username to fetch the charts of.
- **api_key** (string) - Required - A Last.fm API key.
- **from** (string) - Optional - The date at which the chart should start from.
- **to** (string) - Optional - The date at which the chart should end on.
- **format** (string) - Optional - The response format (e.g., json).

### Response
#### Success Response (200)
- **weeklyartistchart** (object) - The root element containing the user, from, and to attributes, and a list of artist objects.

#### Response Example
<weeklyartistchart user="RJ" from="1212321600" to="1212926400">
  <artist rank="1">
    <name>David Hudson and Friends</name>
    <mbid>80e577ba-841f-43ba-9f32-72e7c1692336</mbid>
    <playcount>18</playcount>
    <url>http://www.last.fm/music/David+Hudson+and+Friends</url>
  </artist>
</weeklyartistchart>
```

--------------------------------

### Sample XML Response for user.getTopTracks

Source: https://www.last.fm/api/show/user.getTopTracks

The XML response structure containing track details, playcounts, and artist information.

```xml
<toptracks user="RJ" type="overall">  
  <track rank="1">
    <name>Learning to Live</name>
    <playcount>42</playcount>
    <mbid/>
    <url>
      http://www.last.fm/music/Dream+Theater/_/Learning+to+Live
    </url>
    <streamable fulltrack="0">1</streamable>
    <artist>
      <name>Dream Theater</name>
      <mbid>28503ab7-8bf2-4666-a7bd-2644bfc7cb1d</mbid>
      <url>http://www.last.fm/music/Dream+Theater</url>
    </artist>
    <image size="small">...</image>
    <image size="medium">...</image>
    <image size="large">...</image>
  </track>
  ...
</toptracks>
```

--------------------------------

### GET /2.0/?method=user.getweeklyalbumchart

Source: https://www.last.fm/api/show/user.getWeeklyAlbumChart

Retrieves the weekly album chart for a specified user.

```APIDOC
## GET /2.0/?method=user.getweeklyalbumchart

### Description
Get an album chart for a user profile, for a given date range. If no date range is supplied, it will return the most recent album chart for this user.

### Method
GET

### Endpoint
/2.0/?method=user.getweeklyalbumchart

### Parameters
#### Query Parameters
- **user** (string) - Required - The last.fm username to fetch the charts of.
- **from** (string) - Optional - The date at which the chart should start from.
- **to** (string) - Optional - The date at which the chart should end on.
- **api_key** (string) - Required - A Last.fm API key.

### Response
#### Success Response (200)
- **weeklyalbumchart** (object) - The weekly album chart data for the user.

#### Response Example
<weeklyalbumchart user="RJ" from="1212321600" to="1212926400">
  <album rank="1">
    <artist mbid="80e577ba-841f-43ba-9f32-72e7c1692336">David Hudson</artist>
    <name>Bedarra</name>
    <mbid>dc30face-71db-413a-bcae-06accbd64aae</mbid>
    <playcount>10</playcount>
    <url>http://www.last.fm/music/David+Hudson+and+Friends/Bedarra</url>
  </album>
</weeklyalbumchart>
```

--------------------------------

### Sample XML Response for track.getTopTags

Source: https://www.last.fm/api/show/track.getTopTags

The response returns a list of tags with their respective names, counts, and URLs.

```xml
<toptags artist="Cher" track="Believe">
  <tag>
    <name>pop</name>
    <count>97</count>
    <url>www.last.fm/tag/pop</url>
  </tag>
  <tag>
    <name>dance</name>
    <count>88</count>
    <url>www.last.fm/tag/dance</url>
  </tag>
  ...
</toptags>
```
Tokens:
Raw