Last.fm · Schema

Artist

A music artist on Last.fm with metadata, stats, biography, similar artists, and tags.

MusicMusic MetadataScrobblingMusic DiscoveryStreaming

Properties

Name Type Description
name string The artist's name.
mbid string The MusicBrainz identifier for the artist.
url string The Last.fm URL for the artist.
image array Artist images in various sizes.
streamable string Whether the artist is streamable on Last.fm.
ontour string Whether the artist is currently on tour.
stats object Listener and playcount statistics.
similar object
tags object
bio object Artist biography information.
View JSON Schema on GitHub

JSON Schema

artist.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/last-fm/main/json-schema/artist.json",
  "title": "Artist",
  "description": "A music artist on Last.fm with metadata, stats, biography, similar artists, and tags.",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The artist's name."
    },
    "mbid": {
      "type": "string",
      "description": "The MusicBrainz identifier for the artist."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "description": "The Last.fm URL for the artist."
    },
    "image": {
      "type": "array",
      "description": "Artist images in various sizes.",
      "items": {
        "$ref": "#/$defs/Image"
      }
    },
    "streamable": {
      "type": "string",
      "description": "Whether the artist is streamable on Last.fm."
    },
    "ontour": {
      "type": "string",
      "description": "Whether the artist is currently on tour."
    },
    "stats": {
      "type": "object",
      "description": "Listener and playcount statistics.",
      "properties": {
        "listeners": {
          "type": "string",
          "description": "Total number of unique listeners."
        },
        "playcount": {
          "type": "string",
          "description": "Total number of plays."
        },
        "userplaycount": {
          "type": "string",
          "description": "Plays by the requesting user (if username parameter supplied)."
        }
      }
    },
    "similar": {
      "type": "object",
      "properties": {
        "artist": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/SimilarArtist"
          }
        }
      }
    },
    "tags": {
      "type": "object",
      "properties": {
        "tag": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/Tag"
          }
        }
      }
    },
    "bio": {
      "type": "object",
      "description": "Artist biography information.",
      "properties": {
        "published": {
          "type": "string",
          "description": "Date the biography was published."
        },
        "summary": {
          "type": "string",
          "description": "Short summary of the biography."
        },
        "content": {
          "type": "string",
          "description": "Full biography content."
        }
      }
    }
  },
  "required": ["name", "url"],
  "$defs": {
    "Image": {
      "type": "object",
      "properties": {
        "#text": {
          "type": "string",
          "format": "uri",
          "description": "The image URL."
        },
        "size": {
          "type": "string",
          "enum": ["small", "medium", "large", "extralarge", "mega"],
          "description": "The image size."
        }
      }
    },
    "Tag": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "url": {
          "type": "string",
          "format": "uri"
        }
      },
      "required": ["name"]
    },
    "SimilarArtist": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "mbid": {
          "type": "string"
        },
        "match": {
          "type": "string",
          "description": "Similarity score between 0 and 1."
        },
        "url": {
          "type": "string",
          "format": "uri"
        },
        "image": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/Image"
          }
        }
      },
      "required": ["name"]
    }
  }
}