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.

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 uuid required

    Unique ID of the track.

  • name string required

    Name of the collection

  • tracks object[] required
  • Array [
  • id string required

    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 string required

    Title of the track

  • bpm int32 required

    Beats per minute for the track.

  • length int32 required

    Track length in seconds

  • moods object[] required

    Lists the moods of the track.

  • Array [
  • id string required

    Unique ID of the mood

  • name string required

    Name of the mood

  • ]
  • genres object[] required

    Lists the genres of the track.

  • Array [
  • id string required
  • name string required
  • parent object
  • id string required

    Unique ID of the parent genre

  • name string required

    Name of the parent genre

  • ]
  • images object
  • default string nullable
  • L string nullable
  • M string nullable
  • S string nullable
  • XS string nullable
  • waveformUrl string required

    Reference to the waveform as a json object.

  • hasVocals boolean nullable

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

  • added string required

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

  • tierOption string nullable

    Possible values: [PAID, FREE]

  • isExplicit boolean nullable
  • isPreviewOnly boolean
  • ]
  • availableTracks int32 nullable

    Number of available tracks based on the partner's tier

  • images object required
  • default string required
  • L string nullable
  • M string nullable
  • S string nullable
  • XS string nullable
  • ]
  • pagination object required
  • page int32 required
  • limit int32 required
  • offset int32
  • links object required
  • next string nullable
  • prev string nullable
Loading...