Download track
GEThttps://partner-content-api.epidemicsound.com/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).
Request
Path Parameters
Track id
Query Parameters
Possible values: [mp3
]
Track format
Possible values: [normal
, high
]
Track quality, normal is used as the default if not specified
normal
Responses
- 200
- 400
- 401
- 403
- 404
- 429
Information about download url
- application/json
- Schema
- Example (from schema)
- Example
Schema
{
"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
Human readable message
errors
object[]
{
"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
Human readable message
errors
object[]
{
"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
Human readable message
errors
object[]
{
"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
Human readable message
errors
object[]
{
"message": "string",
"errors": [
{
"key": "string",
"messages": [
"string"
]
}
]
}
{
"message": "Track was not found"
}
Rate limit exceeded.
- application/json
- Schema
- Example (from schema)
- Example
Schema
Human readable message
errors
object[]
{
"message": "string",
"errors": [
{
"key": "string",
"messages": [
"string"
]
}
]
}
{
"message": "Rate limit exceeded"
}
Authorization: http
name: UserAuthtype: httpdescription: User authentication is handled with short lived user access tokens. Use a partner token to request these tokens. The access token is of JWT format and should be passed in a header with your API requests: > **Example Header:** `Authorization: Bearer a-user-token`scheme: bearer
- curl
- python
- nodejs
- CURL