# Epidemic Sound

> 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.

App · 24 actions. Web page: https://docs.lodol.com/docs/integrations/epidemic-sound

## Actions

### 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_id`, text, required): 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_id`, text, required): The license's id, from 'List safelisting licenses' or 'Safelist channel or video'.
- Expires (`expires_at`, date and time, required): The new end of the license.

**Outputs**

- `license` (object): The license

**Example output**

```json
{
  "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_id`, text, required): 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**

- `deleted` (true/false): Always true once expired
- `end_user_id` (text): Whose licenses were expired

**Example output**

```json
{
  "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_id`, text, required): 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_id`, text, required): The license's id, from 'List safelisting licenses' or 'Safelist channel or video'.

**Outputs**

- `deleted` (true/false): Always true once expired
- `end_user_id` (text): Whose license it was
- `license_id` (text): The license expired

**Example output**

```json
{
  "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_id`, text, required): The track's id, from 'Search music' or another earlier step.
- Page size (`limit`, number): How many to return, 1 to 60. Epidemic Sound's default is 50. From 1 to 60.
- Offset (`offset`, number): How many to skip: 0 or a whole number of pages. Use the 'next_offset' an earlier page gave. From 0 to 3000.

**Outputs**

- `count` (number): How many came back
- `has_more` (true/false): True if there is another page
- `next_offset` (number): The offset that reads the next page, or null on the last
- `track_id` (text): The track asked about
- `tracks` (list): The similar tracks

**Example output**

```json
{
  "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_id`, text, required): The collection. Pick one, or give its id from an earlier step.
- Page size (`limit`, number): How many to return, 1 to 100. Epidemic Sound's default is 50. From 1 to 100.
- Offset (`offset`, number): How many to skip: 0 or a whole number of pages. Use the 'next_offset' an earlier page gave. From 0 to 3000.

**Outputs**

- `collection` (object): The collection
- `count` (number): How many came back
- `has_more` (true/false): True if there is another page
- `next_offset` (number): The offset that reads the next page, or null on the last
- `tracks` (list): This page of its tracks

**Example output**

```json
{
  "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_id`, text, required): 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_id`, text, required): The license's id, from 'List safelisting licenses' or 'Safelist channel or video'.

**Outputs**

- `license` (object): The license

**Example output**

```json
{
  "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_id`, text, required): The collection. Pick one, or give its id from an earlier step.
- Page size (`limit`, number): How many to return, 1 to 100. Epidemic Sound's default is 50. From 1 to 100.
- Offset (`offset`, number): How many to skip: 0 or a whole number of pages. Use the 'next_offset' an earlier page gave. From 0 to 3000.

**Outputs**

- `collection` (object): The sound effect collection
- `count` (number): How many came back
- `has_more` (true/false): True if there is another page
- `next_offset` (number): The offset that reads the next page, or null on the last
- `sound_effects` (list): This page of its sound effects

**Example output**

```json
{
  "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_id`, text, required): The sound effect's id, from 'Search sound effects' or another earlier step.
- Quality (`quality`, text): 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**

- `expires` (text): When the link stops working (UTC)
- `sound_effect_id` (text): The sound effect asked about
- `url` (text): Signed MP3 address

**Example output**

```json
{
  "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_id`, text, required): The track's id, from 'Search music' or another earlier step.
- Quality (`quality`, text): 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_stems`, true/false): Also return a link to each of the track's stems. Still one download.

**Outputs**

- `expires` (text): When the link stops working (UTC)
- `stems` (list): Stem links, when asked for
- `track_id` (text): The track asked about
- `url` (text): Signed MP3 address

**Example output**

```json
{
  "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_id`, text, required): The track's id, from 'Search music' or another earlier step.
- Lengths (`durations`, list): 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**

- `count` (number): How many
- `highlights` (list): One highlight per length
- `track_id` (text): The track asked about

**Example output**

```json
{
  "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_id`, text, required): The track's id, from 'Search music' or another earlier step.

**Outputs**

- `has_lyrics` (true/false): Whether lyrics came back
- `lyrics` (text): The lyrics, or null
- `track_id` (text): The track asked about

**Example output**

```json
{
  "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_id`, text, required): The track's id, from 'Search music' or another earlier step.

**Outputs**

- `expires` (text): When the link stops working (UTC)
- `track_id` (text): The track asked about
- `url` (text): Signed HLS playlist address (.m3u8)

**Example output**

```json
{
  "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_ids`, list, required): The tracks' ids from an earlier step, or their ISRC codes (such as SE5Q52401263).

**Outputs**

- `count` (number): How many were found
- `requested` (number): How many ids were asked for
- `tracks` (list): The tracks found

**Example output**

```json
{
  "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_tracks`, true/false): Also return each collection's first 20 tracks. Off by default.
- Page size (`limit`, number): How many to return, 1 to 20. Epidemic Sound's default is 10. From 1 to 20.
- Offset (`offset`, number): How many to skip: 0 or a whole number of pages. Use the 'next_offset' an earlier page gave. From 0 to 3000.

**Outputs**

- `collections` (list): The collections
- `count` (number): How many came back
- `has_more` (true/false): True if there is another page
- `next_offset` (number): The offset that reads the next page, or null on the last

**Example output**

```json
{
  "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 (`selection`, text): 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 (`sort`, text): Most popular first, or A to Z. One of: `relevance` (Most popular first (default)), `alphabetic` (A to Z).
- Page size (`limit`, number): How many to return, 1 to 20. Epidemic Sound's default is 20. From 1 to 20.
- Offset (`offset`, number): How many to skip: 0 or a whole number of pages. Use the 'next_offset' an earlier page gave. From 0 to 3000.

**Outputs**

- `count` (number): How many came back
- `genres` (list): The genres
- `has_more` (true/false): True if there is another page
- `next_offset` (number): The offset that reads the next page, or null on the last

**Example output**

```json
{
  "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 (`selection`, text): 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 (`sort`, text): Most popular first, or A to Z. One of: `relevance` (Most popular first (default)), `alphabetic` (A to Z).
- Page size (`limit`, number): How many to return, 1 to 20. Epidemic Sound's default is 20. From 1 to 20.
- Offset (`offset`, number): How many to skip: 0 or a whole number of pages. Use the 'next_offset' an earlier page gave. From 0 to 3000.

**Outputs**

- `count` (number): How many came back
- `has_more` (true/false): True if there is another page
- `moods` (list): The moods
- `next_offset` (number): The offset that reads the next page, or null on the last

**Example output**

```json
{
  "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_id`, text, required): 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_type`, text, required): Channels and profiles, or single videos. One of: `channel` (Channel or profile), `video` (Video (YouTube only)).
- Platform (`platform`, text): Only licenses on this platform. One of: `youtube`, `instagram`, `facebook`, `tiktok`, `twitch`, `podcast` (Podcast (RSS feed)), `website`.
- Sort by (`sort_by`, text): What to sort by. Defaults to expiry date. One of: `expiresAt` (Expiry date (default)), `createdAt` (Date created).
- Order (`sort_order`, text): Which way to sort. Defaults to descending. One of: `desc` (Descending (newest, most, Z to A)), `asc` (Ascending (oldest, least, A to Z)).
- Page (`page`, number): Which page, starting at 1. At least 1.
- Page size (`page_size`, number): How many to a page, 1 to 100. Epidemic Sound's default is 25. From 1 to 100.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): True if there is another page
- `licenses` (list): The licenses
- `page` (number): This page
- `page_size` (number): How many to a page
- `total` (number): How many in all

**Example output**

```json
{
  "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_only`, true/false): Only the categories Epidemic Sound's curators feature.
- Page size (`limit`, number): How many to return, 1 to 100. Epidemic Sound's default is 50. From 1 to 100.
- Offset (`offset`, number): How many to skip: 0 or a whole number of pages. Use the 'next_offset' an earlier page gave. From 0 to 3000.

**Outputs**

- `categories` (list): The categories
- `count` (number): How many came back
- `has_more` (true/false): True if there is another page
- `next_offset` (number): The offset that reads the next page, or null on the last

**Example output**

```json
{
  "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_effects`, true/false): Also return each collection's first 20 sound effects. Off by default.
- Page size (`limit`, number): How many to return, 1 to 20. Epidemic Sound's default is 10. From 1 to 20.
- Offset (`offset`, number): How many to skip: 0 or a whole number of pages. Use the 'next_offset' an earlier page gave. From 0 to 3000.

**Outputs**

- `collections` (list): The sound effect collections
- `count` (number): How many came back
- `has_more` (true/false): True if there is another page
- `next_offset` (number): The offset that reads the next page, or null on the last

**Example output**

```json
{
  "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_id`, text, required): The sound effect category. Pick one, or give its id.
- Sort (`sort`, text): What to sort by. Defaults to newest. One of: `newest` (Newest (default)), `title`, `length`.
- Order (`order`, text): Which way to sort. One of: `desc` (Descending (newest, most, Z to A)), `asc` (Ascending (oldest, least, A to Z)).
- Include explicit (`include_explicit`, true/false): Also include sound effects tagged as explicit. Off by default.
- Page size (`limit`, number): How many to return, 1 to 100. Epidemic Sound's default is 50. From 1 to 100.
- Offset (`offset`, number): 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_id` (text): The category asked about
- `count` (number): How many came back
- `has_more` (true/false): True if there is another page
- `next_offset` (number): The offset that reads the next page, or null on the last
- `sound_effects` (list): The sound effects

**Example output**

```json
{
  "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_ids`, list, required): The tracks used together in the content, up to 50.
- Exported to (`platform`, text, required): 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_platform`, text): The platform's name. Only used when Exported to is Somewhere else.
- End user ID (`end_user_id`, text): Your own anonymous id for the person who exported it, so Epidemic Sound can count use per person. Not an email address.

**Outputs**

- `message` (text): Epidemic Sound's answer, such as Ok
- `platform` (text): Where it was exported
- `reported` (true/false): Always true once reported
- `track_ids` (list): The tracks reported

**Example output**

```json
{
  "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_id`, text, required): 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_type`, text, required): A whole channel or profile, or one video (YouTube only). One of: `channel` (Channel or profile), `video` (Video (YouTube only)).
- Platform (`platform`, text, required): Where the channel or video is. One of: `youtube`, `instagram`, `facebook`, `tiktok`, `twitch`, `podcast` (Podcast (RSS feed)), `website`.
- Address (`url`, text, required): 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_at`, date and time): When the license ends, such as when their subscription does. Leave empty for no end.

**Outputs**

- `license` (object): The license

**Example output**

```json
{
  "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 (`term`, text): 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 (`moods`, list): Only tracks with these moods.
- Genres (`genres`, list): Only tracks in these genres. A parent genre includes its sub-genres.
- With several moods or genres (`match`, text): 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 (`vocals`, list): 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_min`, number): Only tracks at least this many beats per minute. From 1 to 400.
- Fastest tempo (BPM) (`bpm_max`, number): Only tracks at most this many beats per minute. From 1 to 400.
- Sort (`sort`, text): 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 (`order`, text): Which way to sort. One of: `desc` (Descending (newest, most, Z to A)), `asc` (Ascending (oldest, least, A to Z)).
- Page size (`limit`, number): How many to return, 1 to 60. Epidemic Sound's default is 50. From 1 to 60.
- Offset (`offset`, number): How many to skip: 0 or a whole number of pages. Use the 'next_offset' an earlier page gave. From 0 to 3000.

**Outputs**

- `count` (number): How many came back
- `genre_counts` (list): Matching tracks per genre
- `has_more` (true/false): True if there is another page
- `mood_counts` (list): Matching tracks per mood
- `next_offset` (number): The offset that reads the next page, or null on the last
- `tracks` (list): The tracks found

**Example output**

```json
{
  "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 (`term`, text, required): Words describing the sound.
- Sort (`sort`, text): What to sort by. Defaults to best match. One of: `best-match` (Best match (default)), `newest`, `popular` (Most popular), `length`, `title`.
- Order (`order`, text): Which way to sort. One of: `desc` (Descending (newest, most, Z to A)), `asc` (Ascending (oldest, least, A to Z)).
- Include explicit (`include_explicit`, true/false): Also include sound effects tagged as explicit. Off by default.
- Page size (`limit`, number): How many to return, 1 to 60. Epidemic Sound's default is 50. From 1 to 60.
- Offset (`offset`, number): How many to skip: 0 or a whole number of pages. Use the 'next_offset' an earlier page gave. From 0 to 3000.

**Outputs**

- `count` (number): How many came back
- `has_more` (true/false): True if there is another page
- `next_offset` (number): The offset that reads the next page, or null on the last
- `sound_effects` (list): The sound effects found

**Example output**

```json
{
  "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"
    }
  ]
}
```
