Search for tracks
GET /v0/tracks/search
The search endpoint allows your users to search the entire Epidemic Sound library. Search indexes track attributes such as moods, genres, artist, song title and bpm.
Query Parameters
- 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
- term string
Term for search
- genre string[]
Id for genre
- mood string[]
Id for mood
- sort string
Possible values: [
Relevance
,Date
,Title
]Default value:
Relevance
Sort for search
- order string
Possible values: [
Asc
,Desc
]Default value:
Asc
Order
- 200
- 400
- 401
- 403
- 429
- 503
Tracks response
- application/json
- Schema
- Example (from schema)
- Example
Schema
tracks object[] required
Array [id string requiredUnique ID of the track
mainArtists string[] requiredThe main artist that created the track.
featuredArtists string[] requiredAdditional artists that contributed to the track.
title string requiredTitle of the track
bpm int32 requiredBeats per minute for the track.
length int32 requiredTrack length in seconds
moods object[] required
Lists the moods of the track.
Array [id string requiredUnique ID of the mood
name string requiredName of the mood
]genres object[] required
Lists the genres of the track.
Array [id string requiredname string requiredparent object
id string requiredUnique ID of the parent genre
name string requiredName of the parent genre
]images object
default string nullableL string nullableM string nullableS string nullableXS string nullablewaveformUrl string requiredReference to the waveform as a json object.
hasVocals boolean nullableSet to true if the track has vocals. Set to false for instrumental tracks.
added string requiredThe date the track was released in the format YYYY-mm-dd.
tierOption string nullablePossible values: [
PAID
,FREE
]isExplicit boolean nullableisPreviewOnly boolean]pagination object required
page int32 requiredlimit int32 requiredoffset int32links object required
next string nullableprev string nullableaggregations object
moods object[]
Array [id stringname stringcount int32]genres object[]
Array [id stringname stringcount int32]
{
"tracks": [
{
"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
}
],
"pagination": {
"page": 0,
"limit": 0,
"offset": 0
},
"links": {
"next": "string",
"prev": "string"
},
"aggregations": {
"moods": [
{
"id": "string",
"name": "string",
"count": 0
}
],
"genres": [
{
"id": "string",
"name": "string",
"count": 0
}
]
}
}
{
"tracks": [
{
"id": "6rUPerw2po",
"mainArtists": [
"Main Artist"
],
"featuredArtists": [
"Featured Artist"
],
"title": "Happy Song",
"bpm": 135,
"length": 3123,
"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
},
{
"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
}
],
"pagination": {
"page": 2,
"limit": 25,
"offset": 25
},
"links": {
"next": "/v0/tracks/search?limit=25&offset=50",
"prev": "/v0/tracks/search?limit=25&offset=0"
},
"aggregations": {
"moods": [
{
"id": "energetic",
"name": "Energetic",
"count": 1
}
],
"genres": [
{
"id": "rock",
"name": "Rock",
"count": 1
}
]
}
}
Bad request.
- application/json
- Schema
- Example (from schema)
- Example
Schema
- message string required
Human readable message
errors object[]
Array [key string requiredError key
messages string[] requiredError 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 requiredError key
messages string[] requiredError messages
]
{
"message": "string",
"errors": [
{
"key": "string",
"messages": [
"string"
]
}
]
}
{
"message": "Invalid credentials"
}
Forbidden. Only available for ES Connect tokens or User tokens when the app allows to preview tracks.
- application/json
- Schema
- Example (from schema)
- Example
Schema
- message string required
Human readable message
errors object[]
Array [key string requiredError key
messages string[] requiredError messages
]
{
"message": "string",
"errors": [
{
"key": "string",
"messages": [
"string"
]
}
]
}
{
"message": "Forbidden"
}
Rate limit exceeded.
- application/json
- Schema
- Example (from schema)
- Example
Schema
- message string required
Human readable message
errors object[]
Array [key string requiredError key
messages string[] requiredError messages
]
{
"message": "string",
"errors": [
{
"key": "string",
"messages": [
"string"
]
}
]
}
{
"message": "Rate limit exceeded"
}
Service unavailable
- application/json
- Schema
- Example (from schema)
- Example
Schema
- message string required
Human readable message
errors object[]
Array [key string requiredError key
messages string[] requiredError messages
]
{
"message": "string",
"errors": [
{
"key": "string",
"messages": [
"string"
]
}
]
}
{
"message": "Service unavailable"
}