Download track
Changed onThe 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).
Use expand=stems to also get download links for the track's stems (e.g. drums, bass, melody), in the same quality as the track. Which stems exist depends on the track; each stem type appears at most once, and stems is an empty list when the track has none. Identify stems by their type rather than their position in the list. Stem links expire at the same time as the track link. Downloading a track with its stems counts as a single download.
Request
- Base URLhttps://partner-content-api.epidemicsound.com
- Auth
- HTTP bearer
- or OAuth 2Authorization code: https://login.epidemicsound.com/auth/realms/accounts/protocol/openid-connect/authToken URL: https://login.epidemicsound.com/auth/realms/accounts/protocol/openid-connect/token
- or HTTP bearer
Path parameters
Track id
Query parameters
Track format
Track quality, normal is used as the default if not specified
Use stems to include download links for the track's stems in the response
Response
Information about download url
Changes
- info
added the new optional
queryrequest parameterexpand - info
added the optional property
to the response with the status
- info
- info
the endpoint scheme security
ApiKeyAuthwas added to the API
- info