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:

Your API key.

Result schema

Result artist objects follow this schema:


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

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



Retrieves information about The Beatles


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

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:

Additional data to return. Basic metadata is always returned, but if inc is set then the following additional items may be retrieved:
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.



Retrieves information about Portishead


Here's an example response:

	  "name": "Ziggy Stardust",
	  "aliases": [
	    "David Jones",
	    "David Bowie",
	    "David Robert Jones",
	    "The Thin White Duke",
	    "Ziggy Stardust",
	    "Davis Bowie",
	    "Davie Bowie",
	  "country": "",
	  "urls": [
	  "score": 1
comments powered by Disqus
© 2012-2024 elsten software limited, Unit 4934, PO Box 6945, London, W1A 6US, UK | terms and conditions | privacy policy