List collections with tracks
GET /v0/collections
The collections endpoint returns playlists curated by our team of in-house experts.
We offer collections for any occasion: from holidays like “Día de Muertos“ to content types like “Real Estate” or “Badass ads”.
You can manage the order and which collections are part or your applications’ free tier via the developer portal. As default, we return the collections included in your free tier first, followed by all collections in the Epidemic Sound library.
Collections have attributes like title and cover art. In the few cases where we do not have cover art for a collection we return a default image.
You can choose to return collections with or without tracks. The response will include a maximum of 20 tracks per collection. If a collection contains more than 20 tracks use endpoint '/collections/{collectionId}' to get all tracks.
Query Parameters
- excludeField string
Possible values: [
tracks
]Add parameter if tracks should be excluded in the response
- limit int32
Max number of entries returned in the response, default 10 and max 20
- offset int32
Index of the entry track in the response
- 200
- 401
- 429
Collection response
- application/json
- Schema
- Example (from schema)
- Example
Schema
collections object[] required
Array [id uuid requiredUnique ID of the track.
name string requiredName of the collection
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]availableTracks int32 nullableNumber of available tracks based on the partner's tier
images object required
default string requiredL string nullableM string nullableS string nullableXS string nullable]pagination object required
page int32 requiredlimit int32 requiredoffset int32links object required
next string nullableprev string nullable
{
"collections": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "string",
"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
}
],
"availableTracks": 0,
"images": {
"default": "string",
"L": "string",
"M": "string",
"S": "string",
"XS": "string"
}
}
],
"pagination": {
"page": 0,
"limit": 0,
"offset": 0
},
"links": {
"next": "string",
"prev": "string"
}
}
{
"collections": [
{
"id": "4caef099-43bd-4653-8203-3086fa01d3b7",
"name": "Happy",
"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
}
],
"availableTracks": 1,
"images": {
"default": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/default/300x300.jpg",
"L": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/default/1050x1050.jpg",
"M": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/default/600x600.jpg",
"S": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/default/300x300.jpg",
"XS": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/default/128x128.jpg"
}
},
{
"id": "9917d694-511b-4b66-ab8a-c553660399e4",
"name": "Sad",
"tracks": [
{
"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
}
],
"availableTracks": 1,
"images": {
"default": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/default/300x300.jpg",
"L": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/default/1050x1050.jpg",
"M": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/default/600x600.jpg",
"S": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/default/300x300.jpg",
"XS": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/default/128x128.jpg"
}
}
],
"pagination": {
"page": 3,
"limit": 20,
"offset": 40
},
"links": {
"next": "/v0/collections?limit=20&offset=60",
"prev": "/v0/collections?limit=20&offset=20"
}
}
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"
}
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"
}