canonical: https://jentic.com/apis/partner-content-api.epidemicsound.com/epidemic-sound

# Partner Content Api Epidemicsound Partner Content API

Jentic publishes the only available OpenAPI specification for Partner Content API, keeping it validated and agent-ready. The Epidemic Sound Partner Content API provides programmatic access to a catalog of royalty-free music tracks and sound effects for content creators and platforms. It supports searching by genre, mood, and audio similarity, streaming and downloading licensed tracks, managing user subscriptions, and reporting usage analytics across 37 endpoints.

## For AI agents

Search, stream, and download royalty-free music tracks and sound effects from Epidemic Sound. Filter by genre, mood, or audio similarity and report content usage for licensing compliance.

## Scope

Does not handle video editing, audio mixing, or podcast hosting - use for searching, licensing, and downloading music and sound effects only.

## Capabilities

- Search music tracks by keyword, genre, mood, and audio parameters
- Find similar tracks and sections based on audio fingerprinting
- Stream and download licensed tracks and sound effects
- Browse categorized sound effect libraries with nested category trees
- Upload custom audio for similarity matching against the catalog
- Report content usage analytics for licensing compliance
- Retrieve user subscription status and liked track collections

## Use cases

### Video Content Soundtracking

Search the Epidemic Sound catalog by mood, genre, or keyword to find music that matches your video content. The Partner Content API returns track metadata, preview streams, and download URLs with licensing included. Creators can filter by energy level, instrumentation, and duration to find tracks that fit specific scenes without manual catalog browsing.

Example prompt: Search for tracks with mood 'uplifting' and genre 'pop' using the `/v0/tracks/search` endpoint, then retrieve the stream URL for the top result

### Audio Similarity Matching

Upload a reference audio file or specify a track ID to find sonically similar music in the Epidemic Sound catalog. The API uses audio fingerprinting to identify tracks with comparable tempo, key, instrumentation, and energy. This enables automated music recommendation engines and creative tools that suggest alternatives based on a reference track.

Example prompt: Upload an audio file via `/v0/uploads/audio`, then call `/v0/tracks/matching-image/{imageId}` to find catalog tracks matching the reference

### Sound Effect Library Integration

Access Epidemic Sound's categorized sound effect library through dedicated endpoints that provide hierarchical category browsing, category-filtered track listings, and keyword search. Each sound effect includes metadata about duration, format, and category tags, enabling platforms to embed searchable sound effect pickers directly in their editing interfaces.

Example prompt: Retrieve all sound effect categories via `/v0/sound-effects/categories`, then list tracks in the 'nature' category using `/v0/sound-effects/categories/{categoryId}/tracks`

### AI Agent Music Discovery via Jentic

AI agents integrate with the Epidemic Sound Partner Content API through Jentic to search for licensed music tracks by intent without managing Bearer token authentication directly. Jentic handles credential isolation for both partner-level and user-level auth tokens, letting agents discover tracks by describing what they need and executing the matching search operation with structured parameters.

Example prompt: Search Jentic for 'find royalty-free music tracks by mood', load the track search operation schema, and execute with mood parameter set to 'relaxing'

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/v0/tracks/search` | Search music tracks by keyword, genre, and mood |
| GET | `/v0/tracks/{trackId}/download` | Download a licensed track |
| GET | `/v0/tracks/{trackId}/similar` | Find tracks similar to a specific track |
| GET | `/v0/sound-effects/search` | Search the sound effects library |
| GET | `/v0/genres` | List all available genres |
| GET | `/v0/moods` | List all available moods |
| POST | `/v0/uploads/audio` | Upload audio for similarity matching |
| GET | `/v0/tracks/{trackId}/stream` | Get a streaming URL for a track |

## Key resources

- **Tracks** — Search, stream, download, and find similar music tracks
- **Sound Effects** — Browse categories and search the sound effects library
- **Genres** — List and retrieve genre classifications for filtering
- **Moods** — List and retrieve mood tags for emotional filtering
- **Collections** — Access curated track collections
- **Uploads** — Upload audio and images for similarity matching
- **Users** — Retrieve user profile, subscription, and liked tracks

## Why Jentic

- **Setup:** Wiring the Epidemic Sound Partner Content API by hand means learning its bearer and OAuth2 auth for partner-level and user-level access, setting the partner-content-api.epidemicsound.com host, and building search and download handling yourself. Through Jentic you install once, import the Partner Content API from the API Directory, store the credential once, and your agent calls it.
- **Permission scoping:** You limit the agent to the operations it needs, such as searching tracks, fetching similar tracks, or downloading a licensed track by id. You choose the operations it may call, so writes like uploading audio are not included unless you add them.
- **Credential handling:** Your Epidemic Sound bearer or OAuth credential is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'find royalty-free music by mood' or 'download a licensed track', and Jentic returns the matching Epidemic Sound operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **SoundCloud API** — Music streaming platform API for user-generated content and artist tracks
- **Freesound API** — Community-sourced sound effects and audio samples under Creative Commons
- **GitHub API** — Source control platform for managing video project assets and collaboration

## FAQ

### Why is there no official OpenAPI spec for Partner Content API?

Epidemic Sound does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Partner Content API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the Epidemic Sound Partner Content API use?

The API supports three auth schemes: PartnerAuth (Bearer token for platform-level access), UserAuth (Bearer token for user-specific operations like liked tracks), and EpidemicSoundConnectAuth (OAuth 2.0 for end-user authorization flows). Through Jentic, these tokens are stored encrypted and agents receive scoped access without managing token lifecycle.

### Can I search for tracks by mood and genre simultaneously?

Yes. The `/v0/tracks/search` endpoint accepts multiple filter parameters including genre, mood, tempo range, and keyword. You can combine these to narrow results, for example finding 'upbeat electronic' tracks by specifying both the genre and mood parameters in a single request.

### How do I download a licensed track through the API?

Call GET `/v0/tracks/{trackId}/download` with a valid auth token. The endpoint returns the audio file in the licensed format. Your subscription or partner agreement determines which formats and quality levels are available for download.

### What are the rate limits for the Partner Content API?

The OpenAPI spec does not document specific rate limits. Rate allocations are determined by your partner agreement tier with Epidemic Sound. Contact the Epidemic Sound partner team for your specific limits.

### How do I find tracks similar to a specific song using the API?

Use GET `/v0/tracks/{trackId}/similar` to find full tracks with similar audio characteristics, or GET `/v0/tracks/{trackId}/similar-sections` for section-level matches. You can also upload a reference audio file via POST `/v0/uploads/audio` and use the returned ID for matching.

### Can I limit what my agent is allowed to do with the Epidemic Sound Partner Content API?

Yes. Jentic One is self-hosted, so you set the rules that decide which operations and credentials your agent may use. You can allow it to only search tracks, fetch similar tracks, or download a licensed track by id, while excluding writes like uploading audio via POST `/v0/uploads/audio` unless you add them. The agent can only call the endpoints you have granted, so its access stays scoped to the tasks you intend.