Download track

GET /v0/tracks/:trackId/download

The download endpoint allows you to download an MP3 file of the track.

We offer MP3 files in two qualities; normal (128kbps) and high (320kbps).

The high quality files can be used in content when needed, but normal quality is sufficient for most use cases.

The download links expire after 24 hours (normal quality) or 1 hour (high quality files). The expiration time is stated in the response.

All users can download the tracks that are part of the free tier. Only connected users with an active Epidemic Sound subscription can download tracks that are part of the premium library. If a user does not have access to download a track, you will get an error response. You can proactively mark premium tracks in your UI by using the track attribute isPreviewOnly (see track attributes).

Path Parameters

trackId string required
Track id

Query Parameters

format string
Possible values: [mp3]
Track format
quality string
Possible values: [normal, high]
Default value: normal
Track quality, normal is used as the default if not specified

Responses

Information about download url

application/json

Schema
Example (from schema)
Example

Schema

url string required
expires string required

{
  "url": "string",
  "expires": "string"
}

{
  "url": "https://pdn.epidemicsound.com/ES_ITUNES/Happy_Song/ES_Happy_Song.mp3",
  "expires": "2022-12-22T11:01:48Z"
}

Bad request.

application/json

Schema
Example (from schema)
Example

Schema

message string required
Human readable message
errors object[]
Array [
key string required
Error key
messages string[] required
Error messages
]

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

{
  "message": "Bad request"
}

Unauthorized. Most likely your access token has expired.

application/json

Schema
Example (from schema)
Example

Schema

message string required
Human readable message
errors object[]
Array [
key string required
Error key
messages string[] required
Error messages
]

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

{
  "message": "Invalid credentials"
}

User does not have access to download the track.

application/json

Schema
Example (from schema)
Example

Schema

message string required
Human readable message
errors object[]
Array [
key string required
Error key
messages string[] required
Error messages
]

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

{
  "message": "User does not have access to download the track"
}

Track was not found.

application/json

Schema
Example (from schema)
Example

Schema

message string required
Human readable message
errors object[]
Array [
key string required
Error key
messages string[] required
Error messages
]

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

{
  "message": "Track was not found"
}

Rate limit exceeded.

application/json

Schema
Example (from schema)
Example

Schema

message string required
Human readable message
errors object[]
Array [
key string required
Error key
messages string[] required
Error messages
]

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

{
  "message": "Rate limit exceeded"
}