Querying artists

GET /20151208/artist
POST /20151208/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

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

Retrieves information about The Beatles

/20151208/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

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

Retrieves information about Portishead

Response

Here's an example response:

http://api.onemusicapi.com/20151208/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
	}
]
comments powered by Disqus
© 2012-2018 elsten software limited, Unit 4934, PO Box 6945, London, W1A 6US, UK | terms and conditions | privacy policy