Sign in
Tracks

Tracks metadata

The metadata endpoint returns metadata for a list of tracks.

Identify each track by either its track id or its International Standard Recording Code (ISRC), and mix both kinds of value in the same request. The response de-duplicates a track that you request by both its track id and its ISRC.

If a value matches no track, the response omits that track instead of returning an error.

get/v0/tracks/metadata

Query parameters

trackIdstring[] required

List of track identifiers. Each value is either a track id or an ISRC, such as SE5Q52401263. ISRC matching ignores case, dashes, and spaces.

Response

Tracks response

idstring required

Unique ID of the track

mainArtistsstring[] required

The main artist that created the track.

featuredArtistsstring[] required

Additional artists that contributed to the track.

titlestring required

Title of the track

bpminteger required

Beats per minute for the track.

lengthinteger required

Track length in seconds

waveformUrlstring required

Reference to the waveform as a json object.

hasVocalsboolean nullable

Set to true if the track has vocals. Set to false for instrumental tracks.

addedstring required

The date the track was released in the format YYYY-mm-dd.

tierOption'PAID' | 'FREE' nullable
isrcstring nullable

International Standard Recording Code (ISRC) of the track, e.g. "SE5Q52401263".

vocalType'LEAD' | 'PRESENCE' | 'NONE' nullable

Granular vocal classification: LEAD (sung lead vocals), PRESENCE (vocal chops/samples/ad-libs/textures) or NONE (instrumental). Null when unknown.

isExplicitboolean nullable
isPreviewOnlyboolean

Changes