Get metadata for tracks

GET 
/v0/tracks/metadata

The metadata endpoint allows you to get metadata for a list of tracks.

Request

Query Parameters

trackId string[]required

List of track ids

Responses

200

Tracks response

application/json

Schema

Schema

tracks

object[]

required

Array [

id stringrequired

Unique ID of the track

mainArtists string[]required

The main artist that created the track.

featuredArtists string[]required

Additional artists that contributed to the track.

title stringrequired

Title of the track

bpm int32required

Beats per minute for the track.

length int32required

Track length in seconds

moods

object[]

required

Lists the moods of the track.

Array [

id stringrequired

Unique ID of the mood

name stringrequired

Name of the mood

]

genres

object[]

required

Lists the genres of the track.

Array [

id stringrequired

name stringrequired

parent

object

id stringrequired

Unique ID of the parent genre

name stringrequired

Name of the parent genre

]

images

object

default stringnullable

L stringnullable

M stringnullable

S stringnullable

XS stringnullable

waveformUrl stringrequired

Reference to the waveform as a json object.

hasVocals booleannullable

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

added stringrequired

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

tierOption stringnullable

Possible values: [PAID, FREE]

isExplicit booleannullable

isPreviewOnly boolean

]

pagination

object

required

page int32required

limit int32required

offset int32

links

object

required

next stringnullable

prev stringnullable

aggregations

object

moods

object[]

Array [

id string

name string

count int32

]

genres

object[]

Array [

id string

name string

count int32

]

Example (from schema)

{
  "tracks": [
    {
      "id": "string",
      "mainArtists": [
        "string"
      ],
      "featuredArtists": [
        "string"
      ],
      "title": "string",
      "bpm": 0,
      "length": 0,
      "moods": [
        {
          "id": "string",
          "name": "string"
        }
      ],
      "genres": [
        {
          "id": "string",
          "name": "string",
          "parent": {
            "id": "string",
            "name": "string"
          }
        }
      ],
      "images": {
        "default": "string",
        "L": "string",
        "M": "string",
        "S": "string",
        "XS": "string"
      },
      "waveformUrl": "string",
      "hasVocals": true,
      "added": "string",
      "tierOption": "PAID",
      "isExplicit": true,
      "isPreviewOnly": true
    }
  ],
  "pagination": {
    "page": 0,
    "limit": 0,
    "offset": 0
  },
  "links": {
    "next": "string",
    "prev": "string"
  },
  "aggregations": {
    "moods": [
      {
        "id": "string",
        "name": "string",
        "count": 0
      }
    ],
    "genres": [
      {
        "id": "string",
        "name": "string",
        "count": 0
      }
    ]
  }
}

Example

[
  {
    "id": "6rUPerw2po",
    "mainArtists": [
      "Main Artist"
    ],
    "featuredArtists": [
      "Featured Artist"
    ],
    "title": "Happy Song",
    "bpm": 135,
    "length": 3123,
    "moods": [
      {
        "id": "happy",
        "name": "Happy"
      },
      {
        "id": "eccentric",
        "name": "Eccentric"
      }
    ],
    "genres": [
      {
        "id": "beats",
        "name": "Beats",
        "parent": {
          "id": "parent",
          "name": "Parent Beats"
        }
      },
      {
        "id": "trap",
        "name": "Trap"
      }
    ],
    "images": {
      "default": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/123456/300x300.jpg",
      "L": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/123456/1050x1050.jpg",
      "M": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/123456/600x600.jpg",
      "S": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/123456/300x300.jpg",
      "XS": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/123456/128x128.jpg"
    },
    "waveformUrl": "https://pdn.epidemicsound.com/waveforms/1600/394079.json",
    "hasVocals": true,
    "added": "2020-10-10",
    "isExplicit": false,
    "isPreviewOnly": true
  },
  {
    "id": "0dZCtol3bs",
    "mainArtists": [
      "Main Artist"
    ],
    "featuredArtists": [
      "Featured Artist"
    ],
    "title": "Sad Song",
    "bpm": 97,
    "length": 2976,
    "moods": [
      {
        "id": "happy",
        "name": "Happy"
      },
      {
        "id": "eccentric",
        "name": "Eccentric"
      }
    ],
    "genres": [
      {
        "id": "beats",
        "name": "Beats",
        "parent": {
          "id": "parent",
          "name": "Parent Beats"
        }
      },
      {
        "id": "trap",
        "name": "Trap"
      }
    ],
    "images": {
      "default": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/123456/300x300.jpg",
      "L": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/123456/1050x1050.jpg",
      "M": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/123456/600x600.jpg",
      "S": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/123456/300x300.jpg",
      "XS": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/123456/128x128.jpg"
    },
    "waveformUrl": "https://pdn.epidemicsound.com/waveforms/1600/394079.json",
    "hasVocals": true,
    "added": "2020-10-10",
    "isExplicit": false,
    "isPreviewOnly": true
  }
]

400

Bad request.

application/json

Schema

Schema

message stringrequired

Human readable message

errors

object[]

Array [

key stringrequired

Error key

messages string[]required

Error messages

]

Example (from schema)

{
  "message": "string",
  "errors": [
    {
      "key": "string",
      "messages": [
        "string"
      ]
    }
  ]
}

Example

{
  "message": "Bad request"
}

401

Unauthorized. Most likely your access token has expired.

application/json

Schema

Schema

message stringrequired

Human readable message

errors

object[]

Array [

key stringrequired

Error key

messages string[]required

Error messages

]

Example (from schema)

{
  "message": "string",
  "errors": [
    {
      "key": "string",
      "messages": [
        "string"
      ]
    }
  ]
}

Example

{
  "message": "Invalid credentials"
}

429

Rate limit exceeded.

application/json

Schema

Schema

message stringrequired

Human readable message

errors

object[]

Array [

key stringrequired

Error key

messages string[]required

Error messages

]

Example (from schema)

{
  "message": "string",
  "errors": [
    {
      "key": "string",
      "messages": [
        "string"
      ]
    }
  ]
}

Example

{
  "message": "Rate limit exceeded"
}

Loading...