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.
Request
Query Parameters
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
Possible values: [alphabetic
, relevance
]
Sorting options. Available values: alphabetic, relevance
relevance
Possible values: [asc
, desc
]
Order options. Available values: asc, desc
asc
Possible values: [all
, featured
, partner-tier
]
Types to filter by:
all
Max number of entries returned in the response, default 20 and max 20
Index of the entry track in the response
Responses
- 200
- 401
- 429
Track genres response
- application/json
- Schema
- Example (from schema)
- Example
Schema
Array [
]
genres
object[]
required
parent
object
images
object
images
object
pagination
object
required
links
object
required
{
"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
Array [
]
Human readable message
errors
object[]
Error key
Error messages
{
"message": "string",
"errors": [
{
"key": "string",
"messages": [
"string"
]
}
]
}
{
"message": "Invalid credentials"
}
Rate limit exceeded.
- application/json
- Schema
- Example (from schema)
- Example
Schema
Array [
]
Human readable message
errors
object[]
Error key
Error messages
{
"message": "string",
"errors": [
{
"key": "string",
"messages": [
"string"
]
}
]
}
{
"message": "Rate limit exceeded"
}