Epidemic Sound

App · 24 actions

Find royalty-free music and sound effects in Epidemic Sound by words, mood, genre and tempo, get download and preview links with stems, report exports, and safelist your users' channels and videos.

Actions

ActionWhat it does
Change license expiryChange when one of your users' licenses expires, such as when their subscription renews.
Expire all licenses of a userExpire every active license of one of your users, such as when they cancel.
Expire licenseExpire one of your users' licenses now.
Find similar tracksFind tracks that sound like a given track (genre, mood, tempo and more), to replace one that doesn't quite fit.
Get collection tracksGet a collection and a page of its tracks, up to 100 at a time.
Get safelisting licenseGet one of your users' licenses: what it covers and when it expires.
Get sound effect collectionGet a sound effect collection and a page of its sound effects.
Get sound effect download linkGet a signed MP3 link for a sound effect.
Get track download linkGet a signed MP3 link for a track, optionally with its stems (drums, bass, melody and so on).
Get track highlightsGet the most popular stretch of a track for each length asked (30 seconds unless chosen), as start and end times, to cut a short video to.
Get track lyricsGet a track's lyrics as text, line by line.
Get track preview linkGet a signed stream (HLS) for listening to any track, even one your plan can't download.
Get tracksGet tracks by their ids or ISRC codes, with artists, tempo, moods, genres and cover art.
List collectionsList the collections (playlists by Epidemic Sound's curators, such as Lounge or Trending on TikTok) your app offers, optionally with their first 20 tracks.
List genresList genres and sub-genres, such as rock and post rock, with cover art, 20 at a time.
List moodsList moods such as happy, epic or relaxing, with cover art, 20 at a time.
List safelisting licensesList one of your users' active licenses, for channels or for videos, optionally on one platform.
List sound effect categoriesList sound effect categories such as Applause or Crowds, with their parent categories and cover art.
List sound effect collectionsList the sound effect collections active for your app, optionally with their first 20 sound effects.
List sound effects in categoryList the sound effects in a category, newest first unless sorted otherwise.
Report usageTell Epidemic Sound that tracks were used in content exported to a platform such as YouTube or TikTok, or saved to a device.
Safelist channel or videoSafelist one of your users' channels or videos so content using Epidemic Sound music isn't claimed for copyright, optionally until a date.
Search musicSearch Epidemic Sound's music by words, moods, genres, tempo and vocals, sorted by relevance, release date or popularity.
Search sound effectsSearch Epidemic Sound's sound effects by words such as door slam or crowd cheering.

Change license expiry

Change when one of your users' licenses expires, such as when their subscription renews. The expiry is all a license can change.

Inputs

End user IDend_user_idtextRequired
Your own id for the person the license is for, such as their user id in your product. Use an anonymous id, not a name or email address.
License IDlicense_idtextRequired
The license's id, from 'List safelisting licenses' or 'Safelist channel or video'.
Expiresexpires_atdate and timeRequired
The new end of the license.

Outputs

licenseobject
The license
Example output
{
  "license": {
    "asset": {
      "id": "UC_sOjEnngNB2y_AEaDd2cSA",
      "platform": "youtube",
      "type": "channel",
      "url": "https://www.youtube.com/@somechannel"
    },
    "createdAt": "2026-04-01T12:00:00Z",
    "expiresAt": "2027-06-01T00:00:00Z",
    "id": "7f7ae8d4-5a21-48b0-bdc3-6795fbc1dc51"
  }
}

Expire all licenses of a user

Expire every active license of one of your users, such as when they cancel. Succeeds even if they had none.

Inputs

End user IDend_user_idtextRequired
Your own id for the person the license is for, such as their user id in your product. Use an anonymous id, not a name or email address.

Outputs

deletedtrue/false
Always true once expired
end_user_idtext
Whose licenses were expired
Example output
{
  "deleted": true,
  "end_user_id": "user-1042"
}

Expire license

Expire one of your users' licenses now. Content published while it was active stays covered; new content may be claimed.

Inputs

End user IDend_user_idtextRequired
Your own id for the person the license is for, such as their user id in your product. Use an anonymous id, not a name or email address.
License IDlicense_idtextRequired
The license's id, from 'List safelisting licenses' or 'Safelist channel or video'.

Outputs

deletedtrue/false
Always true once expired
end_user_idtext
Whose license it was
license_idtext
The license expired
Example output
{
  "deleted": true,
  "end_user_id": "user-1042",
  "license_id": "7f7ae8d4-5a21-48b0-bdc3-6795fbc1dc51"
}

Find similar tracks

Find tracks that sound like a given track (genre, mood, tempo and more), to replace one that doesn't quite fit.

Inputs

Track IDtrack_idtextRequired
The track's id, from 'Search music' or another earlier step.
Page sizelimitnumber
How many to return, 1 to 60. Epidemic Sound's default is 50.From 1 to 60.
Offsetoffsetnumber
How many to skip: 0 or a whole number of pages. Use the 'next_offset' an earlier page gave.From 0 to 3000.

Outputs

countnumber
How many came back
has_moretrue/false
True if there is another page
next_offsetnumber
The offset that reads the next page, or null on the last
track_idtext
The track asked about
trackslist
The similar tracks
Example output
{
  "count": 1,
  "has_more": false,
  "next_offset": null,
  "track_id": "3f8a1e60-c398-4cec-83bf-4ed5efd3b851",
  "tracks": [
    {
      "added": "2020-02-12",
      "availableStems": [
        "drums",
        "bass",
        "melody"
      ],
      "bpm": 110,
      "featuredArtists": [],
      "genres": [
        {
          "id": "post-rock",
          "name": "Post Rock",
          "parent": {
            "id": "rock",
            "name": "Rock"
          }
        }
      ],
      "hasVocals": false,
      "id": "6rUPerw2po",
      "images": {
        "L": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/1050x1050.jpg",
        "M": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/600x600.jpg",
        "S": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg",
        "XS": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/128x128.jpg",
        "default": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg"
      },
      "isExplicit": false,
      "isPreviewOnly": false,
      "isrc": "SE5Q52401263",
      "length": 178,
      "mainArtists": [
        "Marc Torch"
      ],
      "moods": [
        {
          "id": "epic",
          "name": "Epic"
        },
        {
          "id": "hopeful",
          "name": "Hopeful"
        }
      ],
      "tierOption": "FREE",
      "title": "Happy Song",
      "vocalType": "NONE",
      "waveformUrl": "https://pdn.epidemicsound.com/waveforms/1600/331261.json"
    }
  ]
}

Get collection tracks

Get a collection and a page of its tracks, up to 100 at a time.

Inputs

Collectioncollection_idtextRequired
The collection. Pick one, or give its id from an earlier step.
Page sizelimitnumber
How many to return, 1 to 100. Epidemic Sound's default is 50.From 1 to 100.
Offsetoffsetnumber
How many to skip: 0 or a whole number of pages. Use the 'next_offset' an earlier page gave.From 0 to 3000.

Outputs

collectionobject
The collection
countnumber
How many came back
has_moretrue/false
True if there is another page
next_offsetnumber
The offset that reads the next page, or null on the last
trackslist
This page of its tracks
Example output
{
  "collection": {
    "availableTracks": 64,
    "id": "7a84d049-057a-46fb-93d1-eace263d8973",
    "images": {
      "L": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/1050x1050.jpg",
      "M": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/600x600.jpg",
      "S": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg",
      "XS": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/128x128.jpg",
      "default": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg"
    },
    "name": "Lounge"
  },
  "count": 1,
  "has_more": false,
  "next_offset": null,
  "tracks": [
    {
      "added": "2020-02-12",
      "availableStems": [
        "drums",
        "bass",
        "melody"
      ],
      "bpm": 110,
      "featuredArtists": [],
      "genres": [
        {
          "id": "post-rock",
          "name": "Post Rock",
          "parent": {
            "id": "rock",
            "name": "Rock"
          }
        }
      ],
      "hasVocals": false,
      "id": "3f8a1e60-c398-4cec-83bf-4ed5efd3b851",
      "images": {
        "L": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/1050x1050.jpg",
        "M": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/600x600.jpg",
        "S": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg",
        "XS": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/128x128.jpg",
        "default": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg"
      },
      "isExplicit": false,
      "isPreviewOnly": false,
      "isrc": "SE5Q52401263",
      "length": 178,
      "mainArtists": [
        "Marc Torch"
      ],
      "moods": [
        {
          "id": "epic",
          "name": "Epic"
        },
        {
          "id": "hopeful",
          "name": "Hopeful"
        }
      ],
      "tierOption": "FREE",
      "title": "Solaris",
      "vocalType": "NONE",
      "waveformUrl": "https://pdn.epidemicsound.com/waveforms/1600/331261.json"
    }
  ]
}

Get safelisting license

Get one of your users' licenses: what it covers and when it expires.

Inputs

End user IDend_user_idtextRequired
Your own id for the person the license is for, such as their user id in your product. Use an anonymous id, not a name or email address.
License IDlicense_idtextRequired
The license's id, from 'List safelisting licenses' or 'Safelist channel or video'.

Outputs

licenseobject
The license
Example output
{
  "license": {
    "asset": {
      "id": "UC_sOjEnngNB2y_AEaDd2cSA",
      "platform": "youtube",
      "type": "channel",
      "url": "https://www.youtube.com/@somechannel"
    },
    "createdAt": "2026-04-01T12:00:00Z",
    "expiresAt": "2027-01-01T00:00:00Z",
    "id": "7f7ae8d4-5a21-48b0-bdc3-6795fbc1dc51"
  }
}

Get sound effect collection

Get a sound effect collection and a page of its sound effects.

Inputs

Sound effect collectioncollection_idtextRequired
The collection. Pick one, or give its id from an earlier step.
Page sizelimitnumber
How many to return, 1 to 100. Epidemic Sound's default is 50.From 1 to 100.
Offsetoffsetnumber
How many to skip: 0 or a whole number of pages. Use the 'next_offset' an earlier page gave.From 0 to 3000.

Outputs

collectionobject
The sound effect collection
countnumber
How many came back
has_moretrue/false
True if there is another page
next_offsetnumber
The offset that reads the next page, or null on the last
sound_effectslist
This page of its sound effects
Example output
{
  "collection": {
    "availableSoundEffects": 1,
    "id": "4caef099-43bd-4653-8203-3086fa01d3b7",
    "name": "Crowd & Applause"
  },
  "count": 1,
  "has_more": false,
  "next_offset": null,
  "sound_effects": [
    {
      "added": "2020-10-10T09:30:00Z",
      "id": "5bce703b-11c4-3403-a78a-ac62191e8304",
      "images": {
        "L": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/1050x1050.jpg",
        "M": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/600x600.jpg",
        "S": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg",
        "XS": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/128x128.jpg",
        "default": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg"
      },
      "length": 10,
      "title": "Applause"
    }
  ]
}

Get a signed MP3 link for a sound effect. Each call counts as a download; reuse the link until it expires.

Inputs

Sound effect IDsound_effect_idtextRequired
The sound effect's id, from 'Search sound effects' or another earlier step.
Qualityqualitytext
Normal (128 kbps) suits most videos; its link lasts 24 hours. A high quality link lasts 1 hour.One of: normal (Normal, 128 kbps (default)), high (High, 320 kbps).

Outputs

expirestext
When the link stops working (UTC)
sound_effect_idtext
The sound effect asked about
urltext
Signed MP3 address
Example output
{
  "expires": "2026-11-18T09:49:32Z",
  "sound_effect_id": "5bce703b-11c4-3403-a78a-ac62191e8304",
  "url": "https://pdn.epidemicsound.com/ES_ITUNES/Applause/ES_Applause.mp3"
}

Get a signed MP3 link for a track, optionally with its stems (drums, bass, melody and so on). Each call counts as a download on your plan; reuse the link until it expires.

Inputs

Track IDtrack_idtextRequired
The track's id, from 'Search music' or another earlier step.
Qualityqualitytext
Normal (128 kbps) suits most videos; its link lasts 24 hours. A high quality link lasts 1 hour.One of: normal (Normal, 128 kbps (default)), high (High, 320 kbps).
Include stemsinclude_stemstrue/false
Also return a link to each of the track's stems. Still one download.

Outputs

expirestext
When the link stops working (UTC)
stemslist
Stem links, when asked for
track_idtext
The track asked about
urltext
Signed MP3 address
Example output
{
  "expires": "2026-11-18T09:49:32Z",
  "stems": [
    {
      "type": "drums",
      "url": "https://pdn.epidemicsound.com/audiofiles/lqmp3/01KTH9Z0E92NFZVB2Q2DBRX0XD.mp3"
    }
  ],
  "track_id": "3f8a1e60-c398-4cec-83bf-4ed5efd3b851",
  "url": "https://pdn.epidemicsound.com/ES_ITUNES/Solaris/ES_Solaris.mp3"
}

Get track highlights

Get the most popular stretch of a track for each length asked (30 seconds unless chosen), as start and end times, to cut a short video to.

Inputs

Track IDtrack_idtextRequired
The track's id, from 'Search music' or another earlier step.
Lengthsdurationslist
Up to 5 lengths to find a highlight for. Defaults to 30 seconds.One or more of: 5 (5 seconds), 10 (10 seconds), 15 (15 seconds), 20 (20 seconds), 30 (30 seconds (default)), 45 (45 seconds), 60 (60 seconds).

Outputs

countnumber
How many
highlightslist
One highlight per length
track_idtext
The track asked about
Example output
{
  "count": 1,
  "highlights": [
    {
      "duration": 30,
      "from": 9000,
      "to": 39000
    }
  ],
  "track_id": "3f8a1e60-c398-4cec-83bf-4ed5efd3b851"
}

Get track lyrics

Get a track's lyrics as text, line by line. Instrumentals, and songs whose lyrics aren't registered yet, have none.

Inputs

Track IDtrack_idtextRequired
The track's id, from 'Search music' or another earlier step.

Outputs

has_lyricstrue/false
Whether lyrics came back
lyricstext
The lyrics, or null
track_idtext
The track asked about
Example output
{
  "has_lyrics": true,
  "lyrics": "Verse 1\nLine one\nLine two\n\nChorus\n...",
  "track_id": "6rUPerw2po"
}

Get a signed stream (HLS) for listening to any track, even one your plan can't download. Each call counts as a preview.

Inputs

Track IDtrack_idtextRequired
The track's id, from 'Search music' or another earlier step.

Outputs

expirestext
When the link stops working (UTC)
track_idtext
The track asked about
urltext
Signed HLS playlist address (.m3u8)
Example output
{
  "expires": "2026-11-18T09:49:32Z",
  "track_id": "3f8a1e60-c398-4cec-83bf-4ed5efd3b851",
  "url": "https://hls-storage.epidemicsite.com/hls/v1/q4MImKW47D/daefecd205c01496b42ae6950c446c6e/master.m3u8"
}

Get tracks

Get tracks by their ids or ISRC codes, with artists, tempo, moods, genres and cover art. Ids that match nothing are left out.

Inputs

Track IDs or ISRCstrack_idslistRequired
The tracks' ids from an earlier step, or their ISRC codes (such as SE5Q52401263).

Outputs

countnumber
How many were found
requestednumber
How many ids were asked for
trackslist
The tracks found
Example output
{
  "count": 1,
  "requested": 1,
  "tracks": [
    {
      "added": "2020-02-12",
      "availableStems": [
        "drums",
        "bass",
        "melody"
      ],
      "bpm": 110,
      "featuredArtists": [],
      "genres": [
        {
          "id": "post-rock",
          "name": "Post Rock",
          "parent": {
            "id": "rock",
            "name": "Rock"
          }
        }
      ],
      "hasVocals": false,
      "id": "3f8a1e60-c398-4cec-83bf-4ed5efd3b851",
      "images": {
        "L": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/1050x1050.jpg",
        "M": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/600x600.jpg",
        "S": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg",
        "XS": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/128x128.jpg",
        "default": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg"
      },
      "isExplicit": false,
      "isPreviewOnly": false,
      "isrc": "SE5Q52401263",
      "length": 178,
      "mainArtists": [
        "Marc Torch"
      ],
      "moods": [
        {
          "id": "epic",
          "name": "Epic"
        },
        {
          "id": "hopeful",
          "name": "Hopeful"
        }
      ],
      "tierOption": "FREE",
      "title": "Solaris",
      "vocalType": "NONE",
      "waveformUrl": "https://pdn.epidemicsound.com/waveforms/1600/331261.json"
    }
  ]
}

List collections

List the collections (playlists by Epidemic Sound's curators, such as Lounge or Trending on TikTok) your app offers, optionally with their first 20 tracks.

Inputs

Include tracksinclude_trackstrue/false
Also return each collection's first 20 tracks. Off by default.
Page sizelimitnumber
How many to return, 1 to 20. Epidemic Sound's default is 10.From 1 to 20.
Offsetoffsetnumber
How many to skip: 0 or a whole number of pages. Use the 'next_offset' an earlier page gave.From 0 to 3000.

Outputs

collectionslist
The collections
countnumber
How many came back
has_moretrue/false
True if there is another page
next_offsetnumber
The offset that reads the next page, or null on the last
Example output
{
  "collections": [
    {
      "availableTracks": 64,
      "id": "7a84d049-057a-46fb-93d1-eace263d8973",
      "images": {
        "L": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/1050x1050.jpg",
        "M": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/600x600.jpg",
        "S": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg",
        "XS": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/128x128.jpg",
        "default": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg"
      },
      "name": "Lounge",
      "tracks": [
        {
          "added": "2020-02-12",
          "availableStems": [
            "drums",
            "bass",
            "melody"
          ],
          "bpm": 110,
          "featuredArtists": [],
          "genres": [
            {
              "id": "post-rock",
              "name": "Post Rock",
              "parent": {
                "id": "rock",
                "name": "Rock"
              }
            }
          ],
          "hasVocals": false,
          "id": "3f8a1e60-c398-4cec-83bf-4ed5efd3b851",
          "images": {
            "L": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/1050x1050.jpg",
            "M": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/600x600.jpg",
            "S": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg",
            "XS": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/128x128.jpg",
            "default": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg"
          },
          "isExplicit": false,
          "isPreviewOnly": false,
          "isrc": "SE5Q52401263",
          "length": 178,
          "mainArtists": [
            "Marc Torch"
          ],
          "moods": [
            {
              "id": "epic",
              "name": "Epic"
            },
            {
              "id": "hopeful",
              "name": "Hopeful"
            }
          ],
          "tierOption": "FREE",
          "title": "Solaris",
          "vocalType": "NONE",
          "waveformUrl": "https://pdn.epidemicsound.com/waveforms/1600/331261.json"
        }
      ]
    }
  ],
  "count": 1,
  "has_more": false,
  "next_offset": null
}

List genres

List genres and sub-genres, such as rock and post rock, with cover art, 20 at a time. Use a genre's id to filter 'Search music'.

Inputs

Whichselectiontext
Every one in the library, only featured ones, or only those your plan includes.One of: all (Every one in the library (default)), featured (Featured by Epidemic Sound), partner-tier (Those your plan includes).
Sortsorttext
Most popular first, or A to Z.One of: relevance (Most popular first (default)), alphabetic (A to Z).
Page sizelimitnumber
How many to return, 1 to 20. Epidemic Sound's default is 20.From 1 to 20.
Offsetoffsetnumber
How many to skip: 0 or a whole number of pages. Use the 'next_offset' an earlier page gave.From 0 to 3000.

Outputs

countnumber
How many came back
genreslist
The genres
has_moretrue/false
True if there is another page
next_offsetnumber
The offset that reads the next page, or null on the last
Example output
{
  "count": 1,
  "genres": [
    {
      "id": "post-rock",
      "images": {
        "L": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/1050x1050.jpg",
        "M": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/600x600.jpg",
        "S": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg",
        "XS": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/128x128.jpg",
        "default": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg"
      },
      "name": "Post Rock",
      "parent": {
        "id": "rock",
        "images": {
          "L": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/1050x1050.jpg",
          "M": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/600x600.jpg",
          "S": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg",
          "XS": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/128x128.jpg",
          "default": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg"
        },
        "name": "Rock"
      }
    }
  ],
  "has_more": false,
  "next_offset": null
}

List moods

List moods such as happy, epic or relaxing, with cover art, 20 at a time. Use a mood's id to filter 'Search music'.

Inputs

Whichselectiontext
Every one in the library, only featured ones, or only those your plan includes.One of: all (Every one in the library (default)), featured (Featured by Epidemic Sound), partner-tier (Those your plan includes).
Sortsorttext
Most popular first, or A to Z.One of: relevance (Most popular first (default)), alphabetic (A to Z).
Page sizelimitnumber
How many to return, 1 to 20. Epidemic Sound's default is 20.From 1 to 20.
Offsetoffsetnumber
How many to skip: 0 or a whole number of pages. Use the 'next_offset' an earlier page gave.From 0 to 3000.

Outputs

countnumber
How many came back
has_moretrue/false
True if there is another page
moodslist
The moods
next_offsetnumber
The offset that reads the next page, or null on the last
Example output
{
  "count": 1,
  "has_more": false,
  "moods": [
    {
      "id": "happy",
      "images": {
        "L": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/1050x1050.jpg",
        "M": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/600x600.jpg",
        "S": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg",
        "XS": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/128x128.jpg",
        "default": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg"
      },
      "name": "Happy"
    }
  ],
  "next_offset": null
}

List safelisting licenses

List one of your users' active licenses, for channels or for videos, optionally on one platform.

Inputs

End user IDend_user_idtextRequired
Your own id for the person the license is for, such as their user id in your product. Use an anonymous id, not a name or email address.
Licenses forasset_typetextRequired
Channels and profiles, or single videos.One of: channel (Channel or profile), video (Video (YouTube only)).
Platformplatformtext
Only licenses on this platform.One of: youtube, instagram, facebook, tiktok, twitch, podcast (Podcast (RSS feed)), website.
Sort bysort_bytext
What to sort by. Defaults to expiry date.One of: expiresAt (Expiry date (default)), createdAt (Date created).
Ordersort_ordertext
Which way to sort. Defaults to descending.One of: desc (Descending (newest, most, Z to A)), asc (Ascending (oldest, least, A to Z)).
Pagepagenumber
Which page, starting at 1.At least 1.
Page sizepage_sizenumber
How many to a page, 1 to 100. Epidemic Sound's default is 25.From 1 to 100.

Outputs

countnumber
How many on this page
has_moretrue/false
True if there is another page
licenseslist
The licenses
pagenumber
This page
page_sizenumber
How many to a page
totalnumber
How many in all
Example output
{
  "count": 1,
  "has_more": false,
  "licenses": [
    {
      "asset": {
        "id": "UC_sOjEnngNB2y_AEaDd2cSA",
        "platform": "youtube",
        "type": "channel",
        "url": "https://www.youtube.com/@somechannel"
      },
      "createdAt": "2026-04-01T12:00:00Z",
      "expiresAt": "2027-01-01T00:00:00Z",
      "id": "7f7ae8d4-5a21-48b0-bdc3-6795fbc1dc51"
    }
  ],
  "page": 1,
  "page_size": 25,
  "total": 1
}

List sound effect categories

List sound effect categories such as Applause or Crowds, with their parent categories and cover art.

Inputs

Featured onlyfeatured_onlytrue/false
Only the categories Epidemic Sound's curators feature.
Page sizelimitnumber
How many to return, 1 to 100. Epidemic Sound's default is 50.From 1 to 100.
Offsetoffsetnumber
How many to skip: 0 or a whole number of pages. Use the 'next_offset' an earlier page gave.From 0 to 3000.

Outputs

categorieslist
The categories
countnumber
How many came back
has_moretrue/false
True if there is another page
next_offsetnumber
The offset that reads the next page, or null on the last
Example output
{
  "categories": [
    {
      "id": "5e6d24c3-f6b1-39b9-bba2-f338ce87b08c",
      "images": {
        "L": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/1050x1050.jpg",
        "M": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/600x600.jpg",
        "S": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg",
        "XS": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/128x128.jpg",
        "default": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg"
      },
      "name": "Applause",
      "parent": {
        "id": "791d844a-1c69-3d49-804e-0f60297ec5a4",
        "name": "Crowds"
      }
    }
  ],
  "count": 1,
  "has_more": false,
  "next_offset": null
}

List sound effect collections

List the sound effect collections active for your app, optionally with their first 20 sound effects.

Inputs

Include sound effectsinclude_sound_effectstrue/false
Also return each collection's first 20 sound effects. Off by default.
Page sizelimitnumber
How many to return, 1 to 20. Epidemic Sound's default is 10.From 1 to 20.
Offsetoffsetnumber
How many to skip: 0 or a whole number of pages. Use the 'next_offset' an earlier page gave.From 0 to 3000.

Outputs

collectionslist
The sound effect collections
countnumber
How many came back
has_moretrue/false
True if there is another page
next_offsetnumber
The offset that reads the next page, or null on the last
Example output
{
  "collections": [
    {
      "availableSoundEffects": 1,
      "id": "4caef099-43bd-4653-8203-3086fa01d3b7",
      "name": "Crowd & Applause",
      "soundEffects": [
        {
          "added": "2020-10-10T09:30:00Z",
          "id": "5bce703b-11c4-3403-a78a-ac62191e8304",
          "images": {
            "L": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/1050x1050.jpg",
            "M": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/600x600.jpg",
            "S": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg",
            "XS": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/128x128.jpg",
            "default": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg"
          },
          "length": 10,
          "title": "Applause"
        }
      ]
    }
  ],
  "count": 1,
  "has_more": false,
  "next_offset": null
}

List sound effects in category

List the sound effects in a category, newest first unless sorted otherwise.

Inputs

Categorycategory_idtextRequired
The sound effect category. Pick one, or give its id.
Sortsorttext
What to sort by. Defaults to newest.One of: newest (Newest (default)), title, length.
Orderordertext
Which way to sort.One of: desc (Descending (newest, most, Z to A)), asc (Ascending (oldest, least, A to Z)).
Include explicitinclude_explicittrue/false
Also include sound effects tagged as explicit. Off by default.
Page sizelimitnumber
How many to return, 1 to 100. Epidemic Sound's default is 50.From 1 to 100.
Offsetoffsetnumber
How many to skip: 0 or a whole number of pages. Use the 'next_offset' an earlier page gave.From 0 to 3000.

Outputs

category_idtext
The category asked about
countnumber
How many came back
has_moretrue/false
True if there is another page
next_offsetnumber
The offset that reads the next page, or null on the last
sound_effectslist
The sound effects
Example output
{
  "category_id": "5e6d24c3-f6b1-39b9-bba2-f338ce87b08c",
  "count": 1,
  "has_more": false,
  "next_offset": null,
  "sound_effects": [
    {
      "added": "2020-10-10T09:30:00Z",
      "id": "5bce703b-11c4-3403-a78a-ac62191e8304",
      "images": {
        "L": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/1050x1050.jpg",
        "M": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/600x600.jpg",
        "S": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg",
        "XS": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/128x128.jpg",
        "default": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg"
      },
      "length": 10,
      "title": "Applause"
    }
  ]
}

Report usage

Tell Epidemic Sound that tracks were used in content exported to a platform such as YouTube or TikTok, or saved to a device. Only for music, and only when the finished content is exported.

Inputs

Track IDstrack_idslistRequired
The tracks used together in the content, up to 50.
Exported toplatformtextRequired
Where the content went.One of: YOUTUBE, TIKTOK, INSTAGRAM, FACEBOOK, TWITTER (X (Twitter)), TWITCH, LOCAL (Saved to their device), OTHER (Somewhere else).
Other platformother_platformtext
The platform's name. Only used when Exported to is Somewhere else.
End user IDend_user_idtext
Your own anonymous id for the person who exported it, so Epidemic Sound can count use per person. Not an email address.

Outputs

messagetext
Epidemic Sound's answer, such as Ok
platformtext
Where it was exported
reportedtrue/false
Always true once reported
track_idslist
The tracks reported
Example output
{
  "message": "Ok",
  "platform": "YOUTUBE",
  "reported": true,
  "track_ids": [
    "3f8a1e60-c398-4cec-83bf-4ed5efd3b851"
  ]
}

Safelist channel or video

Safelist one of your users' channels or videos so content using Epidemic Sound music isn't claimed for copyright, optionally until a date. Needs safelisting on your Epidemic Sound plan.

Inputs

End user IDend_user_idtextRequired
Your own id for the person the license is for, such as their user id in your product. Use an anonymous id, not a name or email address.
Safelist aasset_typetextRequired
A whole channel or profile, or one video (YouTube only).One of: channel (Channel or profile), video (Video (YouTube only)).
PlatformplatformtextRequired
Where the channel or video is.One of: youtube, instagram, facebook, tiktok, twitch, podcast (Podcast (RSS feed)), website.
AddressurltextRequired
The channel's, profile's or video's public address, such as https://www.youtube.com/@name, or a podcast's RSS feed.
Expiresexpires_atdate and time
When the license ends, such as when their subscription does. Leave empty for no end.

Outputs

licenseobject
The license
Example output
{
  "license": {
    "asset": {
      "id": "UC_sOjEnngNB2y_AEaDd2cSA",
      "platform": "youtube",
      "type": "channel",
      "url": "https://www.youtube.com/@somechannel"
    },
    "createdAt": "2026-04-01T12:00:00Z",
    "expiresAt": "2027-01-01T00:00:00Z",
    "id": "7f7ae8d4-5a21-48b0-bdc3-6795fbc1dc51"
  }
}

Search music

Search Epidemic Sound's music by words, moods, genres, tempo and vocals, sorted by relevance, release date or popularity. Gets one page; run it again with the next offset it gives for more.

Inputs

Search fortermtext
Words to search for: a title, an artist or a description such as calm beach scene. A Spotify track link finds tracks like it. Leave empty to filter only.
Moodsmoodslist
Only tracks with these moods.
Genresgenreslist
Only tracks in these genres. A parent genre includes its sub-genres.
With several moods or genresmatchtext
Whether a track must have every mood and genre chosen, or any of them.One of: allOf (Match every mood and genre chosen (default)), anyOf (Match any mood or genre chosen).
Vocalsvocalslist
Only tracks with these kinds of vocals. Instrumental means none.One or more of: NONE (Instrumental), PRESENCE (Vocal chops or samples), LEAD (Lead vocals).
Slowest tempo (BPM)bpm_minnumber
Only tracks at least this many beats per minute.From 1 to 400.
Fastest tempo (BPM)bpm_maxnumber
Only tracks at most this many beats per minute.From 1 to 400.
Sortsorttext
What to sort by. Relevance sorts best match first.One of: Relevance (Relevance (default)), Date (Release date), Popularity, Title, Duration (Length), BPM (Tempo (BPM)).
Orderordertext
Which way to sort.One of: desc (Descending (newest, most, Z to A)), asc (Ascending (oldest, least, A to Z)).
Page sizelimitnumber
How many to return, 1 to 60. Epidemic Sound's default is 50.From 1 to 60.
Offsetoffsetnumber
How many to skip: 0 or a whole number of pages. Use the 'next_offset' an earlier page gave.From 0 to 3000.

Outputs

countnumber
How many came back
genre_countslist
Matching tracks per genre
has_moretrue/false
True if there is another page
mood_countslist
Matching tracks per mood
next_offsetnumber
The offset that reads the next page, or null on the last
trackslist
The tracks found
Example output
{
  "count": 1,
  "genre_counts": [
    {
      "count": 1,
      "id": "rock",
      "name": "Rock"
    }
  ],
  "has_more": false,
  "mood_counts": [
    {
      "count": 1,
      "id": "epic",
      "name": "Epic"
    }
  ],
  "next_offset": null,
  "tracks": [
    {
      "added": "2020-02-12",
      "availableStems": [
        "drums",
        "bass",
        "melody"
      ],
      "bpm": 110,
      "featuredArtists": [],
      "genres": [
        {
          "id": "post-rock",
          "name": "Post Rock",
          "parent": {
            "id": "rock",
            "name": "Rock"
          }
        }
      ],
      "hasVocals": false,
      "id": "3f8a1e60-c398-4cec-83bf-4ed5efd3b851",
      "images": {
        "L": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/1050x1050.jpg",
        "M": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/600x600.jpg",
        "S": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg",
        "XS": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/128x128.jpg",
        "default": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg"
      },
      "isExplicit": false,
      "isPreviewOnly": false,
      "isrc": "SE5Q52401263",
      "length": 178,
      "mainArtists": [
        "Marc Torch"
      ],
      "moods": [
        {
          "id": "epic",
          "name": "Epic"
        },
        {
          "id": "hopeful",
          "name": "Hopeful"
        }
      ],
      "tierOption": "FREE",
      "title": "Solaris",
      "vocalType": "NONE",
      "waveformUrl": "https://pdn.epidemicsound.com/waveforms/1600/331261.json"
    }
  ]
}

Search sound effects

Search Epidemic Sound's sound effects by words such as door slam or crowd cheering. Gets one page; run it again with the next offset it gives for more.

Inputs

Search fortermtextRequired
Words describing the sound.
Sortsorttext
What to sort by. Defaults to best match.One of: best-match (Best match (default)), newest, popular (Most popular), length, title.
Orderordertext
Which way to sort.One of: desc (Descending (newest, most, Z to A)), asc (Ascending (oldest, least, A to Z)).
Include explicitinclude_explicittrue/false
Also include sound effects tagged as explicit. Off by default.
Page sizelimitnumber
How many to return, 1 to 60. Epidemic Sound's default is 50.From 1 to 60.
Offsetoffsetnumber
How many to skip: 0 or a whole number of pages. Use the 'next_offset' an earlier page gave.From 0 to 3000.

Outputs

countnumber
How many came back
has_moretrue/false
True if there is another page
next_offsetnumber
The offset that reads the next page, or null on the last
sound_effectslist
The sound effects found
Example output
{
  "count": 1,
  "has_more": false,
  "next_offset": null,
  "sound_effects": [
    {
      "added": "2020-10-10T09:30:00Z",
      "id": "5bce703b-11c4-3403-a78a-ac62191e8304",
      "images": {
        "L": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/1050x1050.jpg",
        "M": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/600x600.jpg",
        "S": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg",
        "XS": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/128x128.jpg",
        "default": "https://cdn.epidemicsound.com/curation-assets/commercial-release-cover-images/4661/300x300.jpg"
      },
      "length": 10,
      "title": "Applause"
    }
  ]
}

On this page