EPepidemicsound
Tracks

Tracks metadata

Changed on

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

Request

  • Base URL
    https://partner-content-api.epidemicsound.com
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: https://login.epidemicsound.com/auth/realms/accounts/protocol/openid-connect/auth
      Token URL: https://login.epidemicsound.com/auth/realms/accounts/protocol/openid-connect/token
    • or HTTP bearer

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.

isExplicitboolean nullable
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.

isPreviewOnlyboolean
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.

availableStemsstring[]

Types of the stems the track has, e.g. ["drums", "bass"]. Empty when the track has no stems. Listed even when the user can't download the track. Download them with expand=stems on the track download endpoint.

Changes