This is documentation for version 20171116 which is deprecated. The current version is 20220401. We will continue to make deprecated versions available to customers who still use them, but new customers should use the latest version.

Querying artists

GET /20171116/artist
POST /20171116/artist

The artists 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.

"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

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

Retrieves information about The Beatles

/20171116/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.

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

Examples

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

Retrieves information about Portishead

Response

Here's an example response:

http://api.onemusicapi.com/20171116/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
	}
]