EPepidemicsound
Browse & search

Search music

Changed on

The search endpoint allows your users to search the entire Epidemic Sound library. Search indexes track attributes such as moods, genres, artist, song title and bpm.

You can also pass a Spotify track link or URI as the term (e.g. https://open.spotify.com/track/{id} or spotify:track:{id}) to find similar Epidemic Sound tracks. The first time a given Spotify track is searched it may not have been analysed yet. In that case the endpoint responds 503 Service Unavailable with a Retry-After header (in seconds) indicating how long to wait before retrying. Repeat the same request after that delay until it succeeds. Analysis of a first-seen track can take from a few seconds up to a couple of minutes, so poll gently and honour Retry-After rather than retrying aggressively.

get/v0/tracks/search

Request

  • Base URL
    https://partner-content-api.epidemicsound.com
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: https://login.epidemicsound.com/auth/realms/accounts/protocol/openid-connect/auth
      Token URL: https://login.epidemicsound.com/auth/realms/accounts/protocol/openid-connect/token
    • or HTTP bearer

Query parameters

offsetinteger

Index of the entry track in the response

Max number of entries returned in the response, default 50 and max 60

termstring

Term for search

genrestring[]

Id for genre

moodstring[]

Id for mood

bpmMininteger

BPM Min

bpmMaxinteger

BPM Max

vocalTypestring[]

Filter by vocal classification: LEAD (sung lead vocals), PRESENCE (vocal chops/samples/ad-libs/textures) or NONE (instrumental). Repeat the parameter to pass multiple values, which are OR-combined.

filterBehaviour'allOf' | 'anyOf'

Control how the API combines several values of the same filter, such as two moods or two genres.

  • allOf returns only tracks that match every value. This is the default.
  • anyOf returns tracks that match at least one value, which widens the result set.

The vocalType filter always combines its values with anyOf.

sort'Title' | 'Relevance' | 'Date' | 'Popularity' | 'Duration' | 'BPM'

Sort for search

order'asc' | 'desc'

Order

Response

Tracks response

Changes