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
| Action | What it does |
|---|---|
| Change license expiry | Change when one of your users' licenses expires, such as when their subscription renews. |
| Expire all licenses of a user | Expire every active license of one of your users, such as when they cancel. |
| Expire license | Expire one of your users' licenses now. |
| Find similar tracks | Find tracks that sound like a given track (genre, mood, tempo and more), to replace one that doesn't quite fit. |
| Get collection tracks | Get a collection and a page of its tracks, up to 100 at a time. |
| Get safelisting license | Get one of your users' licenses: what it covers and when it expires. |
| Get sound effect collection | Get a sound effect collection and a page of its sound effects. |
| Get sound effect download link | Get a signed MP3 link for a sound effect. |
| Get track download link | Get a signed MP3 link for a track, optionally with its stems (drums, bass, melody and so on). |
| 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. |
| Get track lyrics | Get a track's lyrics as text, line by line. |
| Get track preview link | Get a signed stream (HLS) for listening to any track, even one your plan can't download. |
| Get tracks | Get tracks by their ids or ISRC codes, with artists, tempo, moods, genres and cover art. |
| 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. |
| List genres | List genres and sub-genres, such as rock and post rock, with cover art, 20 at a time. |
| List moods | List moods such as happy, epic or relaxing, with cover art, 20 at a time. |
| List safelisting licenses | List one of your users' active licenses, for channels or for videos, optionally on one platform. |
| List sound effect categories | List sound effect categories such as Applause or Crowds, with their parent categories and cover art. |
| List sound effect collections | List the sound effect collections active for your app, optionally with their first 20 sound effects. |
| List sound effects in category | List the sound effects in a category, newest first unless sorted otherwise. |
| 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. |
| 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. |
| Search music | Search Epidemic Sound's music by words, moods, genres, tempo and vocals, sorted by relevance, release date or popularity. |
| Search sound effects | Search 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 ID
end_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 ID
license_idtextRequired - The license's id, from 'List safelisting licenses' or 'Safelist channel or video'.
- Expires
expires_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 ID
end_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 ID
end_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 ID
license_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 ID
track_idtextRequired - The track's id, from 'Search music' or another earlier step.
- Page size
limitnumber - How many to return, 1 to 60. Epidemic Sound's default is 50.From 1 to 60.
- Offset
offsetnumber - 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
- Collection
collection_idtextRequired - The collection. Pick one, or give its id from an earlier step.
- Page size
limitnumber - How many to return, 1 to 100. Epidemic Sound's default is 50.From 1 to 100.
- Offset
offsetnumber - 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 ID
end_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 ID
license_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 collection
collection_idtextRequired - The collection. Pick one, or give its id from an earlier step.
- Page size
limitnumber - How many to return, 1 to 100. Epidemic Sound's default is 50.From 1 to 100.
- Offset
offsetnumber - 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 sound effect download link
Get a signed MP3 link for a sound effect. Each call counts as a download; reuse the link until it expires.
Inputs
- Sound effect ID
sound_effect_idtextRequired - The sound effect's id, from 'Search sound effects' or another earlier step.
- Quality
qualitytext - 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 track download link
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 ID
track_idtextRequired - The track's id, from 'Search music' or another earlier step.
- Quality
qualitytext - 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 stems
include_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 ID
track_idtextRequired - The track's id, from 'Search music' or another earlier step.
- Lengths
durationslist - 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 ID
track_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 track preview link
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 ID
track_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 ISRCs
track_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 tracks
include_trackstrue/false - Also return each collection's first 20 tracks. Off by default.
- Page size
limitnumber - How many to return, 1 to 20. Epidemic Sound's default is 10.From 1 to 20.
- Offset
offsetnumber - 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
- Which
selectiontext - 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). - Sort
sorttext - Most popular first, or A to Z.One of:
relevance(Most popular first (default)),alphabetic(A to Z). - Page size
limitnumber - How many to return, 1 to 20. Epidemic Sound's default is 20.From 1 to 20.
- Offset
offsetnumber - 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
- Which
selectiontext - 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). - Sort
sorttext - Most popular first, or A to Z.One of:
relevance(Most popular first (default)),alphabetic(A to Z). - Page size
limitnumber - How many to return, 1 to 20. Epidemic Sound's default is 20.From 1 to 20.
- Offset
offsetnumber - 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 ID
end_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 for
asset_typetextRequired - Channels and profiles, or single videos.One of:
channel(Channel or profile),video(Video (YouTube only)). - Platform
platformtext - Only licenses on this platform.One of:
youtube,instagram,facebook,tiktok,twitch,podcast(Podcast (RSS feed)),website. - Sort by
sort_bytext - What to sort by. Defaults to expiry date.One of:
expiresAt(Expiry date (default)),createdAt(Date created). - Order
sort_ordertext - Which way to sort. Defaults to descending.One of:
desc(Descending (newest, most, Z to A)),asc(Ascending (oldest, least, A to Z)). - Page
pagenumber - Which page, starting at 1.At least 1.
- Page size
page_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 only
featured_onlytrue/false - Only the categories Epidemic Sound's curators feature.
- Page size
limitnumber - How many to return, 1 to 100. Epidemic Sound's default is 50.From 1 to 100.
- Offset
offsetnumber - 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 effects
include_sound_effectstrue/false - Also return each collection's first 20 sound effects. Off by default.
- Page size
limitnumber - How many to return, 1 to 20. Epidemic Sound's default is 10.From 1 to 20.
- Offset
offsetnumber - 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
- Category
category_idtextRequired - The sound effect category. Pick one, or give its id.
- Sort
sorttext - What to sort by. Defaults to newest.One of:
newest(Newest (default)),title,length. - Order
ordertext - Which way to sort.One of:
desc(Descending (newest, most, Z to A)),asc(Ascending (oldest, least, A to Z)). - Include explicit
include_explicittrue/false - Also include sound effects tagged as explicit. Off by default.
- Page size
limitnumber - How many to return, 1 to 100. Epidemic Sound's default is 50.From 1 to 100.
- Offset
offsetnumber - 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 IDs
track_idslistRequired - The tracks used together in the content, up to 50.
- Exported to
platformtextRequired - Where the content went.One of:
YOUTUBE,TIKTOK,INSTAGRAM,FACEBOOK,TWITTER(X (Twitter)),TWITCH,LOCAL(Saved to their device),OTHER(Somewhere else). - Other platform
other_platformtext - The platform's name. Only used when Exported to is Somewhere else.
- End user ID
end_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 ID
end_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 a
asset_typetextRequired - A whole channel or profile, or one video (YouTube only).One of:
channel(Channel or profile),video(Video (YouTube only)). - Platform
platformtextRequired - Where the channel or video is.One of:
youtube,instagram,facebook,tiktok,twitch,podcast(Podcast (RSS feed)),website. - Address
urltextRequired - The channel's, profile's or video's public address, such as https://www.youtube.com/@name, or a podcast's RSS feed.
- Expires
expires_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 for
termtext - 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.
- Moods
moodslist - Only tracks with these moods.
- Genres
genreslist - Only tracks in these genres. A parent genre includes its sub-genres.
- With several moods or genres
matchtext - 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). - Vocals
vocalslist - 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.
- Sort
sorttext - What to sort by. Relevance sorts best match first.One of:
Relevance(Relevance (default)),Date(Release date),Popularity,Title,Duration(Length),BPM(Tempo (BPM)). - Order
ordertext - Which way to sort.One of:
desc(Descending (newest, most, Z to A)),asc(Ascending (oldest, least, A to Z)). - Page size
limitnumber - How many to return, 1 to 60. Epidemic Sound's default is 50.From 1 to 60.
- Offset
offsetnumber - 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 for
termtextRequired - Words describing the sound.
- Sort
sorttext - What to sort by. Defaults to best match.One of:
best-match(Best match (default)),newest,popular(Most popular),length,title. - Order
ordertext - Which way to sort.One of:
desc(Descending (newest, most, Z to A)),asc(Ascending (oldest, least, A to Z)). - Include explicit
include_explicittrue/false - Also include sound effects tagged as explicit. Off by default.
- Page size
limitnumber - How many to return, 1 to 60. Epidemic Sound's default is 50.From 1 to 60.
- Offset
offsetnumber - 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"
}
]
}