Skip to content

getSimilar

Get tags that are similar to this one. Returns tags ranked by similarity, based on listening data.

No authentication required.

Parameters

Method Type Default Required Description
tag string none ✅ The tag name to search information for.
api_key key none ✅ A Last.fm API key.

Responses

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

Warning

This API call is currently broken and returns an empty array as a response.

Warning

This API call returns 200 OK HTTP status codes even when the response contains an error.

Examples

Example response
Parameter Value
tag metal
api_key YOUR_API_KEY
format json

HTTP status: 200 OK

https://ws.audioscrobbler.com/2.0/?method=tag.getSimilar&tag=metal&api_key=YOUR_API_KEY&format=json
{
  "similartags": {
    "tag": [],
    "@attr": {
      "tag": "n/a"
    }
  }
}