Changelog

V4

Changes

Breaking

• removed /api/v2 endpoint
• replaced /api/v3 endpoint by /api/v4
• removed serDesTimeMs and totalTimeMs fields from FetchArtistResponse
• removed fetchTimeMs, and serDesTimeMs and totalTimeMs field from GetTrackResponse
• removed Unexpected error types from FetchArtistResponse and GetTrackResponse
• replaced NotFound error type from GetTrackResponse by a 404 ‘Not Found’ status code
• removed Error result type from GetTrackResponse
• replaced NoData result type from FetchArtistResponse by a 404 ‘Not Found’ status code

Additions

• endpoints now return 502 ‘Bad Gateway’ errors when target source’s API returns an unexpected reponse

V3

Changes

Breaking

• removed /api/v1 endpoint
• removed timeElapsedMs field in V3 response
• renamed topContributions field to contributions in V3 request
• replaced tracks field of Release objects in result.data.releases field by a tracks field in result.data field containing all SimpleTrack objects related to resulting artist in V3 response
• artists field in SimpleTrack objects is now an array of Contributor objects which consist of a required name property and an optional role property in V3 response
• replaced composer field from SimpleTrack objects by an artist with composer role in V3 response
• type and year fields of SimpleRelease objects are now optional in V3 response

Additions

• added a nameVariants field to Artist objects in V3 response
• added a releaseId optional field to SimpleTrack objects in V3 response
• added a otherIds optional field to SimpleTrack objects in V3 response
• added a /api/v3/tracks/genius/<id> endpoint

Notes

• /api/v2 endpoint is deprecated but kept unchanged until V4
• please refer to API reference for more information