Browse & search

Search music

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

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.

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

Sort for search

order'asc' | 'desc'

Order

Response

Tracks response

Changes

No recorded changes to this endpoint across all 6 revisions of this API.