setlist.fm · Schema

artists

A Result consisting of a list of artists.

MusicConcertsSetlistsLive MusicVenuesArtistsTour DatesEvents

Properties

Name Type Description
artist array result list of artists
total number the total amount of items matching the query
page number the current page. starts at 1
itemsPerPage number the amount of items you get per page
View JSON Schema on GitHub

JSON Schema

setlist-fm-Artists.json Raw ↑
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://api.setlist.fm/schema/Artists",
  "title": "artists",
  "description": "A Result consisting of a list of artists.",
  "type": "object",
  "properties": {
    "artist": {
      "description": "result list of artists",
      "type": "array",
      "items": {
        "$ref": "#/definitions/json_Artist"
      }
    },
    "total": {
      "example": 42,
      "description": "the total amount of items matching the query",
      "type": "number"
    },
    "page": {
      "example": 1,
      "description": "the current page. starts at 1",
      "type": "number"
    },
    "itemsPerPage": {
      "example": 20,
      "description": "the amount of items you get per page",
      "type": "number"
    }
  },
  "example": {
    "artist": [
      {
        "mbid": "b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d",
        "name": "The Beatles",
        "sortName": "Beatles, The",
        "disambiguation": "John, Paul, George and Ringo",
        "url": "https://www.setlist.fm/setlists/the-beatles-23d6a88b.html"
      },
      {
        "mbid": "...",
        "name": "...",
        "sortName": "...",
        "disambiguation": "...",
        "url": "..."
      }
    ],
    "total": 42,
    "page": 1,
    "itemsPerPage": 20
  }
}