Partner Content API (0.1.17)

Request a Partner Token

Request a User Token. This endpoint requires a Partner Token for authentication.

The collections endpoint returns playlists curated by our team of in-house experts.

We offer collections for any occasion: from holidays like "Día de Muertos" to content types like "Real Estate" or "Badass ads".

You can manage the order and which collections are part or your applications' free tier via the developer portal. As default, we return the collections included in your free tier first, followed by all collections in the Epidemic Sound library.

Collections have attributes like title and cover art. In the few cases where we do not have cover art for a collection we return a default image.

You can choose to return collections with or without tracks. The response will include a maximum of 20 tracks per collection. If a collection contains more than 20 tracks use endpoint '/collections/{collectionId}' to get all tracks.

The collections endpoint allows you to list all the tracks in a specific collection.

The search endpoint allows your users to search the entire Epidemic Sound library. Search indexes track attributes such as moods, genres, artist, song title and bpm.

The search suggestions endpoint allows your users to get autocomplete suggestions for Epidemic Sound music or external provider music search.

Returns:

• value: The exact search term to pass to the /tracks/search endpoint.
• title: Display text to show users in the autocomplete UI.
• type - Indicates whether this is a search term of type text or external reference URI (e.g., Spotify track).

Usage: When a user selects a suggestion, use the 'value' field as the 'term' parameter when calling /tracks/search to get matching tracks.

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

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

Get mood details

The genres endpoint allows your users to browse the music catalog based on genres like rock, hiphop or acoustic.

Genres are nested and both parent and child genres are returned in the response. Parent genres have cover art that you can show in your interface.

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

This endpoint gives you the parent and child relationships of a specific genre as well as all tracks that belong to it.

The tracks endpoint allows you to list all tracks based on a specified mood, genre or BPM.

The metadata endpoint allows you to get metadata for a list of tracks.

Get a list of possible track query parameters

The download endpoint allows you to download an MP3 file of the track.

We offer MP3 files in two qualities; normal (128kbps) and high (320kbps).

The high quality files can be used in content when needed, but normal quality is sufficient for most use cases.

The download links expire after 24 hours (normal quality) or 1 hour (high quality files). The expiration time is stated in the response.

All users can download the tracks that are part of the free tier. Only connected users with an active Epidemic Sound subscription can download tracks that are part of the premium library. If a user does not have access to download a track, you will get an error response. You can proactively mark premium tracks in your UI by using the track attribute isPreviewOnly (see track attributes).

The beats endpoint provides information about the timestamps of beats in a track. You can use this endpoint to simplify the process to cut the video in sync with the music.

Unlike BPM which is a single number for the entire track, beats can change dynamically across a music piece. This is particularly valuable for capturing variations in tempo, such as a slower intro, a build-up with faster beats, or changes in rhythm throughout the composition.

The response includes two types of metadata: time and value.

time represents the timestamp of the beat in milliseconds. value indicates the beat's position in a bar (or measure in the US), where 1 corresponds to the first beat (downbeat).

Examples:

Most pop songs have four beats in a bar. For example, if we looked at the beats data for Coolio's 1, 2, 3, 4 it would look something like: 1-2-3-4, 1-2-3-4

However, a waltz has three beats in a bar, and the data would look something like: 1-2-3, 1-2-3

Usage Scenarios:

• Automatically cut a video in sync with the beat

• Adding snap markers aligned with beat timestamps in the UI.

We recommend using HLS to allow users to play/preview a track. The main benefits of this compared to MP3 are smaller file transfers and alternate qualities, allowing the HLS client library to switch to a lower quality when necessary.

The audio is encoded using the AAC coding standard, which results in a smaller footprint for a similar quality compared to MP3. The primary manifest refers to two variant quality streams. HLS client libraries typically choose the optimal quality automatically, based on download speed.

The format consists of audio files split into smaller chunks and manifests that refer to these audio files. Since the format is made up of multiple files, access to these are controlled using cookies.

We provide an example app for iOS that plays HLS streams. Users do not need to connect their account or have an active Epidemic Sound subscription to play any track using HLS streaming. That allows your users to listen to all tracks before they connect their account.

The similar tracks endpoint allows developers to retrieve a list of tracks that are similar to a given reference track. This feature is designed to help users discover tracks that share similar characteristics, such as genre, mood, tempo, and more. This endpoint helps your users replace tracks that don't fit perfectly or discover multiple alternatives to a track they enjoy.

Returns a list of track sections that are matched to the provided audio file id.

The similar segments endpoint allows developers to use part of a track as a reference to search for music segments in the Epidemic Sound catalog that sound similar.

The feature utilizes the Epidemic Audio Reference (EAR) technology to provide users with the ability to quickly find alternative segments of music.

Usage Scenarios:

• Video Editing Templates: Replace default tracks in video templates with segments that fit better.
• Quick Swaps: Swap out a segment of music in a video where the existing track doesn't quite match.
• Creative Iteration: Easily experiment with different music segments to enhance your video's impact.

We recommend using HLS to allow users to play/preview a track. The main benefits of this compared to MP3 are smaller file transfers and alternate qualities, allowing the HLS client library to switch to a lower quality when necessary.

The audio is encoded using the AAC coding standard, which results in a smaller footprint for a similar quality compared to MP3. The primary manifest refers to two variant quality streams. HLS client libraries typically choose the optimal quality automatically, based on download speed.

The format consists of audio files split into smaller chunks and manifests that refer to these audio files.

We provide an example app for iOS that plays HLS streams. Users do not need to connect their account or have an active Epidemic Sound subscription to play any track using HLS streaming. That allows your users to listen to all tracks before they connect their account.

Powered by our 2 billion daily streams on YouTube, the popular segments endpoint uses machine learning to recommend the best time section.

You can use popular segments to start playing the track from the right millisecond, or recommend the right part of the track for shorter content.

The popular segments endpoint provides start and stop timestamps in milliseconds. The default duration is 30 seconds.

The endpoint accepts up to 5 different durations per request where each duration must be at least 5 seconds and at most 60 seconds.

Upload an image from the user's video to get recommendations of tracks in the Epidemic Sound library that would work for the video. Use ImageID retrieved from the Upload Image endpoint to fetch the recommended tracks.