Genre details
GET /v0/genres/:genreId
This endpoint gives you the parent and child relationships of a specific genre as well as all tracks that belong to it.
Path Parameters
- genreId string required
Genre id
Query Parameters
- expand string
Possible values: [
tracks
]Add parameter if tracks should be included in the response
- limit int32
Max number of entries returned in the response, default 50 and max 100
- offset int32
Index of the entry track in the response
- 200
- 401
- 404
- 429
Track genre response
- application/json
- Schema
- Example (from schema)
- Example
Schema
- id string required
- name string required
parent object
id string requiredUnique ID of the parent genre
name string requiredName of the parent genre
children object[] required
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 stringL string nullableM string nullableS string nullableXS string nullabletracks object
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]
{
"id": "string",
"name": "string",
"parent": {
"id": "string",
"name": "string"
},
"children": [
{
"id": "string",
"name": "string",
"parent": {
"id": "string",
"name": "string"
}
}
],
"images": {
"default": "string",
"L": "string",
"M": "string",
"S": "string",
"XS": "string"
},
"tracks": {
"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
}
]
}
}
}
{
"id": "parent-beats",
"name": "Parent Beats",
"children": [
{
"id": "true-beats",
"name": "True Beats",
"parent": {
"id": "parent-beats",
"name": "Parent Beats"
}
}
],
"tracks": {
"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": "parent-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/genres/{genreId}?limit=25&offset=50",
"prev": "/v0/genres/{genreId}?limit=25&offset=0"
}
}
}
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"
}
Genre was not found
- 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": "Genre 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 requiredError key
messages string[] requiredError messages
]
{
"message": "string",
"errors": [
{
"key": "string",
"messages": [
"string"
]
}
]
}
{
"message": "Rate limit exceeded"
}