Querying artists

GET /20220401/artist
POST /20220401/artist

The artist endpoint allows clients to retrieve metadata about given musical artists, given search parameters. The parameters are used to query OneMusicAPI's aggregated database of MusicBrainz, Discogs and Wikipedia data.

Queries can be sent as a GET or POST request.

Mandatory parameters for all queries

All queries must contain the following:

user_key: Your API key.

Result schema

Result artist objects follow this schema:

`Artist`

Field	Type	Description
name	String	The name of the release. E.g. Massive Attack.
aliases	Array of string	Any aliases for the artist. The name of the release. E.g. for David Bowie, The Thin White Duke.
images	Array of `Image` (optional)	Images for this artist.
country	String (optional)	The country or jurisdiction the artist is associated with.
urls	Array of string (optional)	URLs relating to this artist.
resource-url	String	A URL to retrieve more information using artist lookup.
score	Number	How confident, from 0 to 1, that OneMusicAPI has found the correct release.

"called" query

The "called" query allows for artists to be looked up that go by a given name, moniker or alias.

Mandatory parameters

called: A name used by all of the artists to be returned.

Examples

/20220401/artist?user_key=myUserKey&called=fab%20four

Retrieves information about The Beatles

/20220401/artist?user_key=myUserKey&called=Led%20Zeppelin

Retrieves information about Led Zeppelin

Discogs artist ID query

OneMusicAPI accepts Discogs artist IDs to identify artists. When a Discogs artist ID is used to lookup artist information, not only is the Discogs data for that artist returned, but also for the same artist on other databases, such as on MusicBrainz and Wikipedia.

Mandatory parameters

discogsId: The Discogs artist ID which will be used to return data.

Optional parameters for all queries

In addition, all queries can be further constrained with the following parameters:

inc

Additional data to return. Basic metadata is always returned, but if inc is set then the following additional items may be retrieved:

images: Return images associated with this artist. See Querying releases - Result schema - Images.

If the requested data is not available, the remaining artist information is still returned.

Examples

/20220401/artist?user_key=myUserKey&discogsId=2774

Retrieves information about Portishead

Response

Here's an example response:

http://api.onemusicapi.com/20220401/artist?called=Ziggy%20Stardust

[
	{
	  "name": "Ziggy Stardust",
	  "aliases": [
	    "David Jones",
	    "Bowie",
	    "David Bowie",
	    "David Robert Jones",
	    "The Thin White Duke",
	    "Ziggy Stardust",
	    "Davis Bowie",
	    "Davie Bowie",
	  ],
	  "country": "",
	  "urls": [
	    "http:\/\/lyrics.wikia.com\/David_Bowie",
	    "http:\/\/www.teenagewildlife.com\/",
	    "https:\/\/myspace.com\/davidbowie",
	    "http:\/\/www.davidbowiecatalogue.com\/",
	    "http:\/\/www.illustrated-db-discography.nl\/",
	    "http:\/\/fr.wikipedia.org\/wiki\/David_Bowie",
	    "http:\/\/decoda.com\/david-bowie-lyrics",
	    "http:\/\/www.bowiedownunder.com\/",
	    "http:\/\/muzikum.eu\/en\/122-3437\/david-bowie\/lyrics.html",
	    "http:\/\/www.bbc.co.uk\/music\/artists\/5441c29d-3602-4898-b1a1-b77fa23b8e50",
	    "http:\/\/www.youtube.com\/user\/officialdavidbowie",
	    "http:\/\/www.velvetgoldmine.it\/",
	    "http:\/\/www.secondhandsongs.com\/artist\/194",
	    "http:\/\/www.youtube.com\/davidbowie",
	    "http:\/\/www.algonet.se\/~bassman\/",
	    "http:\/\/bowiesongs.wordpress.com\/",
	    "http:\/\/www.bowiewonderworld.com\/",
	    "http:\/\/www.sonymusic.co.jp\/Music\/International\/Arch\/SR\/DavidBowie\/",
	    "http:\/\/www.imdb.com\/name\/nm0000309\/",
	    "https:\/\/myspace.com\/davidbowielegacy",
	    "https:\/\/twitter.com\/DavidBowieReal",
	    "http:\/\/www.youtube.com\/user\/DavidBowieVEVO",
	    "http:\/\/www.littleoogie.com\/",
	    "http:\/\/www.wikidata.org\/wiki\/Q5383",
	    "https:\/\/commons.wikimedia.org\/wiki\/File:David-Bowie_Chicago_2002-08-08_photoby_Adam-Bielawski-cropped.jpg",
	    "http:\/\/rateyourmusic.com\/artist\/david_bowie",
	    "http:\/\/www.discogs.com\/artist\/10263",
	    "http:\/\/viaf.org\/viaf\/56606484",
	    "https:\/\/www.facebook.com\/davidbowie",
	    "http:\/\/www.davidbowie.com\/",
	    "http:\/\/www.allmusic.com\/artist\/mn0000531986"
	  ],
	  "score": 1
	}
]