Similar track segment based on trackID

GET 
/v0/tracks/:trackId/similar-sections

The similar segments endpoint allows developers to use part of a track as a reference to search for music segments in the Epidemic Sound catalog that sound similar.

The feature utilizes the Epidemic Audio Reference (EAR) technology to provide users with the ability to quickly find alternative segments of music.

Usage Scenarios:

• Video Editing Templates: Replace default tracks in video templates with segments that fit better.
• Quick Swaps: Swap out a segment of music in a video where the existing track doesn't quite match.
• Creative Iteration: Easily experiment with different music segments to enhance your video's impact.

Request

Path Parameters

trackId stringrequired

Track id

Query Parameters

start int32required

Start of the section in milliseconds

end int32required

End of the section in milliseconds

offset int32

Index of the entry track in the response

limit int32

Max number of entries returned in the response, default 50 and max 100

Responses

200

Paginated list of similar tracks

application/json

Schema

Schema

trackSections

object[]

required

Array [

track

object

required

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

start int32required

end int32required

]

pagination

object

required

page int32required

limit int32required

offset int32

links

object

required

next stringnullable

prev stringnullable

Example (from schema)

{
  "trackSections": [
    {
      "track": {
        "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
      },
      "start": 0,
      "end": 0
    }
  ],
  "pagination": {
    "page": 0,
    "limit": 0,
    "offset": 0
  },
  "links": {
    "next": "string",
    "prev": "string"
  }
}

Example

{
  "trackSections": [
    {
      "track": {
        "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
      },
      "start": 0,
      "end": 10000
    }
  ],
  "pagination": {
    "page": 4,
    "limit": 20,
    "offset": 60
  },
  "links": {
    "next": "/v0/tracks/trackId/similar-sections?limit=20&offset=80&start=0&end=10000",
    "prev": "/v0/tracks/trackId/similar-sections?limit=20&offset=40&start=0&end=10000"
  }
}

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

Loading...