Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Epidemic Sound Browse & search API

These endpoints will allow you to explore the Epidemic Sound library. You can display tracks grouped in curated playlists, moods or genres or use search to get tracks by any term.

Epidemic Sound Browse & search API is one of 9 APIs that Epidemic Sound publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Browse & search. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 8 operations across 8 paths, and defines 26 schemas. It is described by OpenAPI 3.0.1, at version 0.1.17.

Requests are made against a single base URL, https://partner-content-api.epidemicsound.com.

8 operations 8 paths 26 schemas 8 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
0.1.17
Base URL
https://partner-content-api.epidemicsound.com
Authentication
HTTP Bearer, HTTP Bearer, HTTP Bearer, OAuth 2.0
Resource Areas
1

Authentication & Security 4

Epidemic Sound Browse & search API declares 4 security schemes for authenticating requests. It accepts HTTP bearer tokens (ApiKeyAuth). It accepts HTTP bearer tokens (PartnerAuth). It accepts HTTP bearer tokens (UserAuth). It supports OAuth 2.0 (EpidemicSoundConnectAuth) using the authorizationCode flow.

  • ApiKeyAuth — API key authentication for server-to-server communication. Pass your API key as a Bearer token in the Authorization header. API keys are prefixed with epidemic…
  • PartnerAuth — Partner authentication is handled with short lived partner access tokens. Use your api credentials to request these tokens. The access token is of JWT format a…
  • UserAuth — 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 b…
  • EpidemicSoundConnectAuth — For users signing in with an Epidemic Sound account, user authentication is handled with OpenID Connect, which is a layer on top of OAuth 2.0. Example Header:…

Paths & Operations 8

Across 8 paths, the API surfaces 8 operations — 8 GET. Each is listed below with its method, path, parameters, and response codes.

Browse & search 8

These endpoints will allow you to explore the Epidemic Sound library. You can display tracks grouped in curated playlists, moods or genres or use search to get tracks by any term.

GET
/v0/collections
List collections
GET_Collections 3 params → 200429401
GET
/v0/collections/{collectionId}
Collection details
GET_Collection 3 params → 200400429401404
GET
/v0/tracks/search
Search music
GET_Tracks_Search 9 params → 200400429401403503
GET
/v0/tracks/search/suggestions
Search autosuggest
GET_Tracks_Search_suggestions 1 param → 200400429401403503
GET
/v0/moods
List moods
GET_All_Moods 5 params → 200401429
GET
/v0/moods/{moodId}
Mood details
GET_Mood_details 4 params → 200401429404
GET
/v0/genres
List genres
GET_All_Genres 5 params → 200401429
GET
/v0/genres/{genreId}
Genre details
GET_Genre_details 4 params → 200401429404

Schemas 26

The contract defines 26 schemas that model the data the API accepts and returns. The most detailed are TrackResponse (15 properties), CollectionPaginatedResponse (7 properties), GenreResponseWithChildren (6 properties), MoodImagesResponse (5 properties). Each schema is shown below with its type and property counts.

TrackResponse
object
15 properties 10 required
TaxonomyAggregations
object
2 properties
TracksResponse
object
4 properties 3 required
GenreImagesResponse
object
5 properties
GenreResponse
object
3 properties 2 required
ImagesResponse
object
5 properties
Pagination
object
3 properties 2 required
CollectionsPaginatedResponse
object
3 properties 3 required
Option
object
1 property
MoodResponseWithImages
object
4 properties 2 required
GenreResponseWithChildren
object
6 properties 3 required
GenresWithImagesPaginatedResponse
object
3 properties 3 required
SearchSuggestionsResponse
object
1 property
PaginationLinks
object
2 properties
ParentGenreResponse
object
2 properties 2 required
MoodsPaginatedResponseWithImages
object
3 properties 3 required
CollectionResponse
object
5 properties 4 required
GenreResponseWithImages
object
4 properties 2 required
CollectionImagesPublicResponse
object
5 properties 1 required
TaxonomyAggregation
object
3 properties
MoodImagesResponse
object
5 properties
Error
object
2 properties 2 required
MessageResponse
object
2 properties 1 required
CollectionPaginatedResponse
object
7 properties 6 required
MoodResponse
object
2 properties 2 required
ParentGenreResponseWithImages
object
3 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

epidemic-sound-browse-search-api-openapi.yml Raw ↑

Other APIs Epidemic Sound publishes across the network.

Epidemic Sound Assets API
Epidemic Sound Authentication API
Epidemic Sound Beta API
Epidemic Sound Reporting API
Epidemic Sound Safelisting API
Epidemic Sound Sound effects API
Epidemic Sound Tracks API
Epidemic Sound Users API