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 Tracks API

Endpoints to get track specific information.

Epidemic Sound Tracks 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 Tracks. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 11 operations across 11 paths, and defines 20 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.

11 operations 11 paths 20 schemas 11 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 Tracks 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 11

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

Tracks 11

Endpoints to get track specific information.

GET
/v0/tracks
List tracks based on mood, genre or BPM
GET_Tracks 6 params → 200400429401
GET
/v0/tracks/metadata
Tracks metadata
GET_Tracks_Metadata 1 param → 200400429401
GET
/v0/tracks/parameters
List track parameters
GET_Track_Parameters → 200429401
GET
/v0/tracks/{trackId}/download
Download track
GET_Download 3 params → 200400429401404403
GET
/v0/tracks/{trackId}/hls
Preview track using cookies
GET_HLS_Download_Data 1 param → 200401429400404
GET
/v0/tracks/{trackId}/similar
Similar tracks
GET_Similar_tracks 3 params → 200401429400404
GET
/v0/tracks/similar-sections
Similar track segment based on audio file
GET_Similar_Audio_Match_Section_tracks 5 params → 200401429400404
GET
/v0/tracks/{trackId}/similar-sections
Similar track segment based on trackID
GET_Similar_Section_tracks 5 params → 200401429400404
GET
/v0/tracks/{trackId}/stream
Preview track
GET_Stream 1 param → 200401429400404
GET
/v0/tracks/{trackId}/highlights
Popular segment
GET_Highlights_Details 2 params → 200401429400404
GET
/v0/tracks/matching-image/{imageId}
Tracks based on image
GET_Tracks_Matching_Image 5 params → 200401429400404

Schemas 20

The contract defines 20 schemas that model the data the API accepts and returns. The most detailed are TrackResponse (15 properties), ImagesResponse (5 properties), HLSCookieResponse (5 properties), TracksResponse (4 properties). Each schema is shown below with its type and property counts.

TrackResponse
object
15 properties 10 required
TaxonomyAggregations
object
2 properties
DownloadResponse
object
2 properties 2 required
TracksResponse
object
4 properties 3 required
GenreResponse
object
3 properties 2 required
HighlightsResponse
object
1 property 1 required
ImagesResponse
object
5 properties
Pagination
object
3 properties 2 required
TrackSectionPaginatedResponse
object
3 properties 3 required
HLSDownloadResponse
object
2 properties 2 required
HighlightSectionResponse
object
3 properties 3 required
PaginationLinks
object
2 properties
ParentGenreResponse
object
2 properties 2 required
HLSCookieResponse
object
5 properties 5 required
TrackParametersResponse
object
2 properties 2 required
TaxonomyAggregation
object
3 properties
Error
object
2 properties 2 required
MessageResponse
object
2 properties 1 required
MoodResponse
object
2 properties 2 required
TrackSectionResponse
object
3 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

epidemic-sound-tracks-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 Browse & search API
Epidemic Sound Reporting API
Epidemic Sound Safelisting API
Epidemic Sound Sound effects API
Epidemic Sound Users API