Skip to main content

List collections with tracks

GET 
/v0/collections

The collections endpoint returns playlists curated by our team of in-house experts.

We offer collections for any occasion: from holidays like “Día de Muertos“ to content types like “Real Estate” or “Badass ads”.

You can manage the order and which collections are part or your applications’ free tier via the developer portal. As default, we return the collections included in your free tier first, followed by all collections in the Epidemic Sound library.

Collections have attributes like title and cover art. In the few cases where we do not have cover art for a collection we return a default image.

You can choose to return collections with or without tracks. The response will include a maximum of 20 tracks per collection. If a collection contains more than 20 tracks use endpoint '/collections/{collectionId}' to get all tracks.

Request​

Query Parameters

    excludeField string

    Possible values: [tracks]

    Add parameter if tracks should be excluded in the response

    limit int32

    Max number of entries returned in the response, default 10 and max 20

    offset int32

    Index of the entry track in the response

Responses​

Collection response

Schema

    collections

    object[]

    required

  • Array [

    • id uuidrequired

    Unique ID of the track.

    name stringrequired

    Name of the collection

    tracks

    object[]

    required

  • Array [

    • id stringrequired

    Unique ID of the track

    mainArtists string[]required

    The main artist that created the track.

    featuredArtists string[]required

    Additional artists that contributed to the track.

    title stringrequired

    Title of the track

    bpm int32required

    Beats per minute for the track.

    length int32required

    Track length in seconds

    moods

    object[]

    required

    Lists the moods of the track.

  • Array [

    • id stringrequired

    Unique ID of the mood

    name stringrequired

    Name of the mood

  • ]

    • genres

    object[]

    required

    Lists the genres of the track.

  • Array [

    • id stringrequired
    name stringrequired

    parent

    object

    id stringrequired

    Unique ID of the parent genre

    name stringrequired

    Name of the parent genre

  • ]

    • images

    object

    default stringnullable
    L stringnullable
    M stringnullable
    S stringnullable
    XS stringnullable
    waveformUrl stringrequired

    Reference to the waveform as a json object.

    hasVocals booleannullable

    Set to true if the track has vocals. Set to false for instrumental tracks.

    added stringrequired

    The date the track was released in the format YYYY-mm-dd.

    tierOption stringnullable

    Possible values: [PAID, FREE]

    isExplicit booleannullable
    isPreviewOnly boolean

  • ]

    • availableTracks int32nullable

    Number of available tracks based on the partner's tier

    images

    object

    required

    default stringrequired
    L stringnullable
    M stringnullable
    S stringnullable
    XS stringnullable

  • ]

    • pagination

    object

    required

    page int32required
    limit int32required
    offset int32

    links

    object

    required

    next stringnullable
    prev stringnullable
Loading...