Skip to main content

List moods

GET /v0/moods

The moods endpoint allows your users to browse the music catalog based on moods like happy, epic or relaxing. Moods have cover art that you can show in your interface.

By specifying the “type” of moods you want to display, you can choose to show all moods in the Epidemic Sound library, only the moods that are featured on epidemicsound.com or only the moods that are available for your free tier tracks.

Query Parameters
  • sort string

    Possible values: [alphabetic, relevance]

    Default value: relevance

    Sorting options. Available values: alphabetic, relevance

  • order string

    Possible values: [asc, desc]

    Default value: asc

    Order options. Available values: asc, desc

  • type string

    Possible values: [all, featured, partner-tier]

    Default value: all

    Types to filter by:

    • all - all the objects in the Epidemic Sound library
    • partner-tier - objects available to the partner within their tier
    • featured - only objects featured and curated by Epidemic Sound
  • limit int32

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

  • offset int32

    Index of the entry track in the response

Responses

Track moods response

Schema
  • moods object[] required
  • Array [
  • id string required
  • name string required
  • images object
  • default string nullable
  • L string nullable
  • M string nullable
  • S string nullable
  • XS string nullable
  • tracks object
  • 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
  • ]
  • pagination object required
  • page int32 required
  • limit int32 required
  • offset int32
  • links object required
  • next string nullable
  • prev string nullable
  • aggregations object
  • moods object[]
  • Array [
  • id string
  • name string
  • count int32
  • ]
  • genres object[]
  • Array [
  • id string
  • name string
  • count int32
  • ]
  • ]
  • pagination object required
  • page int32 required
  • limit int32 required
  • offset int32
  • links object required
  • next string nullable
  • prev string nullable
Loading...