docs / music-metadata

Music Metadata

Artists, albums, tracks and cover art.

base /music-metadata/v18 endpoints

post/music-metadata/v1/search1 credit

search artist/album/release/recording/track/label/work (Lucene)

Parameter	Required
query	required
type	optional
limit	optional
offset	optional

Try in playground →

post/music-metadata/v1/artist_detail1 credit

artist + relationships (members/collaborations), discography, aliases, tags

Parameter	Required
mbid	required
inc	optional

Try in playground →

post/music-metadata/v1/album_detail1 credit

release (tracklist+labels+ISRCs+discids) or release-group

Parameter	Required
mbid	required
entity	optional
inc	optional

Try in playground →

post/music-metadata/v1/track_detail1 credit

recording + ISRCs + work-relations + artist credits

Parameter	Required
mbid	required
inc	optional

Try in playground →

post/music-metadata/v1/label1 credit

label detail (country, label-code, aliases, url-rels)

Parameter	Required
mbid	required
inc	optional

Try in playground →

post/music-metadata/v1/work_detail1 credit

work/composition + ISWC + writer relations

Parameter	Required
mbid	required
inc	optional

Try in playground →

post/music-metadata/v1/isrc_lookup1 credit

reverse ISRC -> recordings (cross-catalog key)

Parameter	Required
isrc	required
inc	optional

Try in playground →

post/music-metadata/v1/cover_art1 credit

Cover-Art-Archive images (multi-resolution) for a release/release-group

Parameter	Required
mbid	required
entity	optional

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/music-metadata/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"radiohead","type":"artist"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}