Search music
GEThttps://partner-content-api.epidemicsound.com/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.
Request
Query Parameters
Index of the entry track in the response
Max number of entries returned in the response, default 50 and max 60
Term for search
Id for genre
Id for mood
Possible values: [Relevance
, Date
, Title
]
Sort for search
Relevance
Possible values: [asc
, desc
]
Order
asc
Responses
- 200
- 400
- 401
- 403
- 429
- 503
Tracks response
- application/json
- Schema
- Example (from schema)
- Example
Schema
tracks
object[]
required
pagination
object
required
links
object
required
aggregations
object
{
"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",
"M": "string",
"L": "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",
"M": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/123456/600x600.jpg",
"L": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/123456/1050x1050.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",
"M": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/123456/600x600.jpg",
"L": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/123456/1050x1050.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": "/tracks/search?limit=25&offset=50",
"prev": "/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
Human readable message
errors
object[]
{
"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
Human readable message
errors
object[]
{
"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
Human readable message
errors
object[]
{
"message": "string",
"errors": [
{
"key": "string",
"messages": [
"string"
]
}
]
}
{
"message": "Forbidden"
}
Rate limit exceeded.
- application/json
- Schema
- Example (from schema)
- Example
Schema
Human readable message
errors
object[]
{
"message": "string",
"errors": [
{
"key": "string",
"messages": [
"string"
]
}
]
}
{
"message": "Rate limit exceeded"
}
Service unavailable
- application/json
- Schema
- Example (from schema)
- Example
Schema
Human readable message
errors
object[]
{
"message": "string",
"errors": [
{
"key": "string",
"messages": [
"string"
]
}
]
}
{
"message": "Service unavailable"
}
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/search' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'