List songs

get

https://api.soundstripe.com/v1/songs

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

filter[bpm][max]

int32

Maximum BPM

filter[bpm][min]

int32

Minimum BPM

filter[duration][consider_alternate_audio_files]

boolean

If true, songs will be returned if any of their audio files (not just the primary audio file) match the supplied duration min, max, or both (whatever is supplied). If false, songs will be returned if their primary audio file matches the supplied duration min, max, or both (whatever is supplied). Only active when used with duration min, max, or both.

filter[duration][max]

int32

Maximum duration of the song's primary audio file

filter[duration][min]

int32

Minimum duration of the song's primary audio file

filter[energy]

string

Energy to filter by. One of: very_low, low, medium or high.

filter[include_alternate_audio_files]

boolean

If true, all audio files for each song will be returned in the audio_files relationship, and in the top-level included key. If false, only primary audio files will be returned in the audio_files relationship, and in the top-level included key. By default, this is false, because response size will be larger when including all audio files for each song.

filter[instrumental]

boolean

If true, only show songs that have at least one instrumental audio file. If false, don't show songs with instrumental audio files.

filter[q]

string

Search query

filter[tags][characteristic]

string

Comma-separated characteristic tags to filter by. Tag IDs or names can be used interchangeably to filter. If a tag ID or name is prefixed with a hyphen (-), songs with that tag will be filtered out. To get a list of all possible characteristic tags, see the list tags endpoint.

filter[tags][genre]

string

Comma-separated genre tags to filter by. Tag IDs or names can be used interchangeably to filter. If a tag ID or name is prefixed with a hyphen (-), songs with that tag will be filtered out. To get a list of all possible genre tags, see the list tags endpoint.

filter[tags][instrument]

string

Comma-separated instrument tags to filter by. Tag IDs or names can be used interchangeably to filter. If a tag ID or name is prefixed with a hyphen (-), songs with that tag will be filtered out. To get a list of all possible instrument tags, see the list tags endpoint.

filter[tags][mood]

string

Comma-separated mood tags to filter by. Tag IDs or names can be used interchangeably to filter. If a tag ID or name is prefixed with a hyphen (-), songs with that tag will be filtered out. To get a list of all possible mood tags, see the list tags endpoint.

filter[vocals]

boolean

If true, only show songs that have at least one vocal audio file. If false, don't show songs with vocal audio files.

Responses

200200

400400