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.

Path Parameters

trackId string required
Track id

Query Parameters

start int32 required
Start of the section in milliseconds
end int32 required
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

Paginated list of similar tracks

application/json

Schema
Example (from schema)
Example

Schema

trackSections object[] required
Array [
track object required
id string required
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 string required
Title of the track
bpm int32 required
Beats per minute for the track.
length int32 required
Track length in seconds
moods object[] required
Lists the moods of the track.
Array [
id string required
Unique ID of the mood
name string required
Name of the mood
]
genres object[] required
Lists the genres of the track.
Array [
id string required
name string required
parent object
id string required
Unique ID of the parent genre
name string required
Name of the parent genre
]
images object
default string nullable
L string nullable
M string nullable
S string nullable
XS string nullable
waveformUrl string required
Reference to the waveform as a json object.
hasVocals boolean nullable
Set to true if the track has vocals. Set to false for instrumental tracks.
added string required
The date the track was released in the format YYYY-mm-dd.
tierOption string nullable
Possible values: [PAID, FREE]
isExplicit boolean nullable
isPreviewOnly boolean
start int32 required
end int32 required
]
pagination object required
page int32 required
limit int32 required
offset int32
links object required
next string nullable
prev string nullable

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

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

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

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