Partner Content Api Epidemicsound Partner Content API
Agent-ready OpenAPI document · curated by JenticMediaAudio Processingbearer, oauth237 EndpointsREST
Know of an official OpenAPI document? Contribute it →
For 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.
Use for: I need to find royalty-free background music for a video, Search for upbeat tracks in the electronic genre, I want to download a licensed sound effect for my project, Find tracks similar to a reference audio file
Not supported: Does not handle video editing, audio mixing, or podcast hosting - use for searching, licensing, and downloading music and sound effects only.
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.
Install Jentic One Beta
Connect the Partner Content API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Partner Content API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fpartner-content-api.epidemicsound.com%2Fepidemic-sound" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fpartner-content-api.epidemicsound.com%2Fepidemic-sound" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Partner Content API.
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
Patterns agents use Partner Content API for, with concrete tasks.
★ 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.
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.
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.
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.
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
37 endpoints — jentic publishes the only available openapi specification for partner content api, keeping it validated and agent-ready.
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
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
Why Jentic?
What agents get from Jentic-routed access to this vendor.
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 isolation
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.
Intent-based discovery
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
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Partner Content API through Jentic.
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.
GET STARTED