Preview track

GET 
https://partner-content-api.epidemicsound.com/v0/tracks/:trackId/stream

We recommend using HLS to allow users to play/preview a track. The main benefits of this compared to MP3 are smaller file transfers and alternate qualities, allowing the HLS client library to switch to a lower quality when necessary.

The audio is encoded using the AAC coding standard, which results in a smaller footprint for a similar quality compared to MP3. The primary manifest refers to two variant quality streams. HLS client libraries typically choose the optimal quality automatically, based on download speed.

The format consists of audio files split into smaller chunks and manifests that refer to these audio files.

We provide an example app for iOS that plays HLS streams. Users do not need to connect their account or have an active Epidemic Sound subscription to play any track using HLS streaming. That allows your users to listen to all tracks before they connect their account.

Request

Path Parameters

trackId stringrequired

Track id

Responses

200

Information about the stream url

application/json

Schema

Schema

url stringrequired
expires stringrequired

Example (from schema)

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

Example

{
  "url": "https://hls-storage.epidemicsite.com/hls/v1/q4MImKW47D/daefecd205c01496b42ae6950c446c6e/master.m3u8",
  "expires": "2022-12-22T11:01:48Z"
}

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"
}

404

Track was not found.

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": "Track was not found"
}

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"
}

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

curl -L 'https://partner-content-api.epidemicsound.com/v0/tracks/:trackId/stream' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

Request Collapse all

Base URL

https://partner-content-api.epidemicsound.com

Auth

Security Scheme

UserAuthEpidemicSoundConnectAuth

Bearer Token

Parameters

trackId — pathrequired

ResponseClear

Click the Send API Request button above and see the response here!