List genres
GET /v0/genres
The genres endpoint allows your users to browse the music catalog based on genres like rock, hiphop or acoustic.
Genres are nested and both parent and child genres are returned in the response. Parent genres have cover art that you can show in your interface.
By specifying the “type” of genres you want to display, you can choose to show all genres in the Epidemic Sound library, only the genres that are featured on epidemicsound.com or only the genres that are available for your free tier tracks.
Query Parameters
- sort string
Possible values: [
alphabetic
,relevance
]Default value:
relevance
Sorting options. Available values: alphabetic, relevance
- order string
Possible values: [
asc
,desc
]Default value:
asc
Order options. Available values: asc, desc
- type string
Possible values: [
all
,featured
,partner-tier
]Default value:
all
Types to filter by:
all
- all the objects in the Epidemic Sound librarypartner-tier
- objects available to the partner within their tierfeatured
- only objects featured and curated by Epidemic Sound
- limit int32
Max number of entries returned in the response, default 20 and max 20
- offset int32
Index of the entry track in the response
- 200
- 401
- 429
Track genres response
- application/json
- Schema
- Example (from schema)
- Example
Schema
genres object[] required
Array [id string requiredname string requiredparent object
id string requiredname string requiredimages object
default stringL string nullableM string nullableS string nullableXS string nullableimages object
default stringL string nullableM string nullableS string nullableXS string nullable]pagination object required
page int32 requiredlimit int32 requiredoffset int32links object required
next string nullableprev string nullable
{
"genres": [
{
"id": "string",
"name": "string",
"parent": {
"id": "string",
"name": "string",
"images": {
"default": "string",
"L": "string",
"M": "string",
"S": "string",
"XS": "string"
}
},
"images": {
"default": "string",
"L": "string",
"M": "string",
"S": "string",
"XS": "string"
}
}
],
"pagination": {
"page": 0,
"limit": 0,
"offset": 0
},
"links": {
"next": "string",
"prev": "string"
}
}
{
"genres": [
{
"id": "beats",
"name": "Beats",
"images": {
"default": "https://images.ctfassets.net/ojtnytzl1djm/4Mm4kJ9nwasLwZpQ54472a/90f35901413025d5a627fa132f6c2b56/Beats.jpg?w=300&h=300&fit=fill&q=90&fm=jpg",
"L": "https://images.ctfassets.net/ojtnytzl1djm/4Mm4kJ9nwasLwZpQ54472a/90f35901413025d5a627fa132f6c2b56/Beats.jpg?w=1050&h=1050&fit=fill&q=90&fm=jpg",
"M": "https://images.ctfassets.net/ojtnytzl1djm/4Mm4kJ9nwasLwZpQ54472a/90f35901413025d5a627fa132f6c2b56/Beats.jpg?w=600&h=600&fit=fill&q=90&fm=jpg",
"S": "https://images.ctfassets.net/ojtnytzl1djm/4Mm4kJ9nwasLwZpQ54472a/90f35901413025d5a627fa132f6c2b56/Beats.jpg?w=300&h=300&fit=fill&q=90&fm=jpg",
"XS": "https://images.ctfassets.net/ojtnytzl1djm/4Mm4kJ9nwasLwZpQ54472a/90f35901413025d5a627fa132f6c2b56/Beats.jpg?w=128&h=128&fit=fill&q=90&fm=jpg"
}
}
],
"pagination": {
"page": 1,
"limit": 20,
"offset": 0
},
"links": {}
}
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"
}