Epidemic Sound website screenshot

Epidemic Sound

Epidemic Sound is a Stockholm-based royalty-free music and sound effects licensing platform for video creators, businesses, and platforms. The catalog includes 55,000+ tracks across 390 genres, 250,000+ sound effects, stems and instrumental versions, all under an all-inclusive license that covers mechanical, sync, and public performance rights globally. The Partner Content API ("Epidemic Sound Connect") exposes the full catalog and Epidemic Sound's AI-powered soundtracking tools — Soundmatch (video-to-music recommendation), semantic search, similar-track and similar-section lookup, image-based matching, beat detection, HLS streaming previews, AI voiceover generation, and the new track-versions endpoint that adapts a recording to a target duration while preserving musical structure. An official Model Context Protocol (MCP) server (beta) makes the same catalog and tools available to AI agents at https://www.epidemicsound.com/a/mcp-service/mcp. Access to the Partner API is gated behind a partnership agreement; once signed, partner engineers receive credentials via the Developer Portal and authenticate using API Key, Partner Token, or Epidemic Sound Connect (OAuth 2.0).

1 APIs 21 Features
MusicSound EffectsRoyalty-Free MusicAudioAudio LicensingSoundtrackingSync LicensingCreatorsVideoAI VoiceoverSemantic SearchMCP

APIs

Epidemic Sound Partner Content API

Single REST API exposing the entire Epidemic Sound catalog — tracks, collections, moods, genres, sound effects, stems, beats, HLS previews, similar-track/section search, image-b...

Collections

Pricing Plans

Rate Limits

Epidemic Sound Rate Limits

2 limits

RATE LIMITS

FinOps

Features

55,000+ royalty-free music tracks across 390 genres
250,000+ sound effects across categorized collections
Stems and instrumental versions included with every track
All-inclusive licensing covering mechanical, sync, and public performance rights worldwide
Semantic search by natural-language description
Soundmatch — video-frame analysis returning mood-matched track recommendations
Similar-track and similar-section discovery for seamless audio replacement
Image-based track matching (`/v0/tracks/matching-image/{imageId}`)
Beat detection for video-sync workflows (`/v0/tracks/{trackId}/beats`)
HLS streaming previews with cookie-authenticated playback
Track-versions generation (beta) — adapt a track to a target duration while preserving structure
AI voiceover generation via the MCP server (browse artists, generate, status, download)
Partner audio and image uploads for similarity / matching workflows
Safelisting licenses for end-user YouTube/social channels
Usage and analytics reporting endpoints for partner billing reconciliation
Three authentication modes — ApiKey, Partner Token, Epidemic Sound Connect (OAuth 2.0)
Official Model Context Protocol (MCP) server (Beta) at https://www.epidemicsound.com/a/mcp-service/mcp
Audio delivered via Fastly's global CDN; API hosted in Europe
Versioned API surface with `/v0/` path prefix
30-day-rotation API keys for programmatic MCP access
Partnership-gated access; credentials provisioned via the Developer Portal

Resources

🔗
Website
Website
🌐
Portal
Portal
🌐
Portal
Portal
🔗
Documentation
Documentation
🔗
Documentation
Documentation
🔗
Documentation
Documentation
🚀
GettingStarted
GettingStarted
🔑
Authentication
Authentication
🔗
SwaggerUI
SwaggerUI
🔗
OpenAPI
OpenAPI
🔗
MCP
MCP
💰
Pricing
Pricing
🔗
Plans
Plans
🔗
RateLimits
RateLimits
🔗
FinOps
FinOps
📰
Blog
Blog
📰
Blog
Blog
🔗
Careers
Careers
🔗
About
About
🔗
Contact
Contact
📜
TermsOfService
TermsOfService
📜
PrivacyPolicy
PrivacyPolicy
👥
GitHubOrganization
GitHubOrganization
📦
SDKs
SDKs
📦
SDKs
SDKs
🔗
LinkedIn
LinkedIn
🔗
Twitter
Twitter
👥
YouTube
YouTube
🔗
Instagram
Instagram
🔗
Facebook
Facebook
🔗
TikTok
TikTok
🔗
Apps
Apps
🔗
Partners
Partners

Sources

Raw ↑
opencollection: 1.0.0
info:
  name: Partner Content API
  version: 0.1.17
items:
- info:
    name: Browse & search
    type: folder
  items:
  - info:
      name: List collections
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/collections
      params:
      - name: excludeField
        value: ''
        type: query
        description: Add parameter if tracks should be excluded in the response
      - name: limit
        value: ''
        type: query
        description: Max number of entries returned in the response, default 10 and max 20
      - name: offset
        value: ''
        type: query
        description: Index of the entry track in the response
    docs: '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 a'
  - info:
      name: Collection details
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/collections/:collectionId
      params:
      - name: collectionId
        value: ''
        type: path
        description: Collection id
      - name: limit
        value: ''
        type: query
        description: Max number of entries returned in the response, default 50 and max 100
      - name: offset
        value: ''
        type: query
        description: Index of the entry track in the response
    docs: The collections endpoint allows you to list all the tracks in a specific collection.
  - info:
      name: Search music
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/tracks/search
      params:
      - name: offset
        value: ''
        type: query
        description: Index of the entry track in the response
      - name: limit
        value: ''
        type: query
        description: Max number of entries returned in the response, default 50 and max 60
      - name: term
        value: ''
        type: query
        description: Term for search
      - name: genre
        value: ''
        type: query
        description: Id for genre
      - name: mood
        value: ''
        type: query
        description: Id for mood
      - name: bpmMin
        value: ''
        type: query
        description: BPM Min
      - name: bpmMax
        value: ''
        type: query
        description: BPM Max
      - name: sort
        value: ''
        type: query
        description: Sort for search
      - name: order
        value: ''
        type: query
        description: Order
    docs: 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.
  - info:
      name: Search autosuggest
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/tracks/search/suggestions
      params:
      - name: term
        value: ''
        type: query
        description: Term for search
    docs: '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 /trac'
  - info:
      name: List moods
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/moods
      params:
      - name: sort
        value: ''
        type: query
        description: 'Sorting options. Available values: alphabetic, relevance'
      - name: order
        value: ''
        type: query
        description: 'Order options. Available values: asc, desc'
      - name: type
        value: ''
        type: query
        description: "Types to filter by:\n  * `all` - all the objects in the Epidemic Sound library\n  * `partner-tier` -\
          \ objects available to the partner within their tier\n  * `featured` - only objects featured and curated by Epidemic\
          \ Sound"
      - name: limit
        value: ''
        type: query
        description: Max number of entries returned in the response, default 20 and max 20
      - name: offset
        value: ''
        type: query
        description: Index of the entry track in the response
    docs: '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.'
  - info:
      name: Mood details
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/moods/:moodId
      params:
      - name: moodId
        value: ''
        type: path
        description: Mood id
      - name: expand
        value: ''
        type: query
        description: Add parameter if tracks should be included in the response
      - name: limit
        value: ''
        type: query
        description: Max number of entries returned in the response, default 50 and max 100
      - name: offset
        value: ''
        type: query
        description: Index of the entry track in the response
    docs: Get mood details
  - info:
      name: List genres
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/genres
      params:
      - name: sort
        value: ''
        type: query
        description: 'Sorting options. Available values: alphabetic, relevance'
      - name: order
        value: ''
        type: query
        description: 'Order options. Available values: asc, desc'
      - name: type
        value: ''
        type: query
        description: "Types to filter by:\n  * `all` - all the objects in the Epidemic Sound library\n  * `partner-tier` -\
          \ objects available to the partner within their tier\n  * `featured` - only objects featured and curated by Epidemic\
          \ Sound"
      - name: limit
        value: ''
        type: query
        description: Max number of entries returned in the response, default 20 and max 20
      - name: offset
        value: ''
        type: query
        description: Index of the entry track in the response
    docs: "The genres endpoint allows your users to browse the music catalog based on genres like rock, hiphop or acoustic.\
      \ \n\nGenres 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.\n\nBy 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 trac"
  - info:
      name: Genre details
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/genres/:genreId
      params:
      - name: genreId
        value: ''
        type: path
        description: Genre id
      - name: expand
        value: ''
        type: query
        description: Add parameter if tracks should be included in the response
      - name: limit
        value: ''
        type: query
        description: Max number of entries returned in the response, default 50 and max 100
      - name: offset
        value: ''
        type: query
        description: Index of the entry track in the response
    docs: This endpoint gives you the parent and child relationships of a specific genre as well as all tracks that belong
      to it.
- info:
    name: Sound effects
    type: folder
  items:
  - info:
      name: List sound-effect collections
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/sound-effects/collections
      params:
      - name: excludeField
        value: ''
        type: query
        description: Pass `soundEffects` to omit sound-effect data from the response and return only collection metadata.
      - name: limit
        value: ''
        type: query
        description: Max number of collections returned in the response, default 10 and max 20
      - name: offset
        value: ''
        type: query
        description: Index of the entry track in the response
    docs: 'Returns the sound-effect collections active for your application.


      Sound-effect collections are managed via the developer portal: an admin imports an EMS

      playlist into a collection, and end users see only Active collections through this endpoint.


      Every application has access to every sound effect, so there is no per-tier cap and no

      paid/free distinction. Up to 20 sound effects per collection are included by default;

      pass `excludeField=soundEffects` to omit them, or paginate the full set via

      `/s'
  - info:
      name: Sound-effect collection details
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/sound-effects/collections/:collectionId
      params:
      - name: collectionId
        value: ''
        type: path
        description: Collection id
      - name: limit
        value: ''
        type: query
        description: Max number of entries returned in the response, default 50 and max 100
      - name: offset
        value: ''
        type: query
        description: Index of the entry track in the response
    docs: Returns a single sound-effect collection along with a paginated set of its sound effects. Use `limit` and `offset`
      to page through the collection.
  - info:
      name: List SFX categories
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/sound-effects/categories
      params:
      - name: type
        value: ''
        type: query
        description: Category type
      - name: offset
        value: ''
        type: query
        description: Index of the entry track in the response
      - name: limit
        value: ''
        type: query
        description: Max number of entries returned in the response, default 50
    docs: 'The sound effects categories endpoint allows you to get a list of all sound effects categories.


      You can then browse the sound effects catalog based on categories like "Applause" or "Crowds".


      Some sound effect categories have cover art that you can use in your interface. You can choose to display all categories,
      or choose type "featured" to only show the categories that are chosen by our curation team.'
  - info:
      name: SFX category details
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/sound-effects/categories/:categoryId
      params:
      - name: categoryId
        value: ''
        type: path
        description: Category id
    docs: 'The category details endpoint contains info on the requested sound effects category.


      The purpose of this endpoint is to be able to validate that an individual object exists in the API if it was cached
      by the client.'
  - info:
      name: List SFX by category
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/sound-effects/categories/:categoryId/tracks
      params:
      - name: categoryId
        value: ''
        type: path
        description: Category id
      - name: offset
        value: ''
        type: query
        description: Index of the entry track in the response
      - name: limit
        value: ''
        type: query
        description: Max number of entries returned in the response, default 50 and max 100
      - name: sort
        value: ''
        type: query
        description: Sort
      - name: order
        value: ''
        type: query
        description: Order
      - name: includeExplicit
        value: ''
        type: query
        description: Whether to include sound effects tagged as explicit in the results. Defaults to false, meaning explicit
          content is excluded by default.
    docs: Use the sound effects details endpoint to display all sound effects for a given category.
  - info:
      name: Download sound effect
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/sound-effects/:trackId/download
      params:
      - name: trackId
        value: ''
        type: path
        description: Track id
      - name: format
        value: ''
        type: query
        description: Track format
      - name: quality
        value: ''
        type: query
        description: Track quality, normal is used as the default if not specified
    docs: 'The download endpoint allows you to download an MP3 file of the sound effect.


      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.'
  - info:
      name: Search SFX
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/sound-effects/search
      params:
      - name: offset
        value: ''
        type: query
        description: Index of the entry track in the response
      - name: limit
        value: ''
        type: query
        description: Max number of entries returned in the response, default 50 and max 60
      - name: term
        value: ''
        type: query
        description: Term for search
      - name: sort
        value: ''
        type: query
        description: Sort for search
      - name: order
        value: ''
        type: query
        description: Order
      - name: includeExplicit
        value: ''
        type: query
        description: Whether to include sound effects tagged as explicit in the results. Defaults to false, meaning explicit
          content is excluded by default.
    docs: 'Use the sound effects search endpoint to allow users to search within the sound effects library.

      '
- info:
    name: Tracks
    type: folder
  items:
  - info:
      name: List tracks based on mood, genre or BPM
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/tracks
      params:
      - name: genre
        value: ''
        type: query
        description: Id for genre
      - name: mood
        value: ''
        type: query
        description: Id for mood
      - name: bpmMin
        value: ''
        type: query
        description: BPM Min
      - name: bpmMax
        value: ''
        type: query
        description: BPM Max
      - name: limit
        value: ''
        type: query
        description: Max number of entries returned in the response, default 50 and max 100
      - name: offset
        value: ''
        type: query
        description: Index of the entry track in the response
    docs: The tracks endpoint allows you to list all tracks based on a specified mood, genre or BPM.
  - info:
      name: Tracks metadata
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/tracks/metadata
      params:
      - name: trackId
        value: ''
        type: query
        description: List of track ids
    docs: The metadata endpoint allows you to get metadata for a list of tracks.
  - info:
      name: List track parameters
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/tracks/parameters
    docs: Get a list of possible track query parameters
  - info:
      name: Download track
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/tracks/:trackId/download
      params:
      - name: trackId
        value: ''
        type: path
        description: Track id
      - name: format
        value: ''
        type: query
        description: Track format
      - name: quality
        value: ''
        type: query
        description: Track quality, normal is used as the default if not specified
    docs: "The download endpoint allows you to download an MP3 file of the track. \n\nWe offer MP3 files in two qualities;\
      \ normal (128kbps) and high (320kbps).\n\nThe high quality files can be used in content when needed, but normal quality\
      \ is sufficient for most use cases. \n\nThe download links expire after 24 hours (normal quality) or 1 hour (high quality\
      \ files). The expiration time is stated in the response. \n\nAll users can download the tracks that are part of the\
      \ free tier. Only connected users with an acti"
  - info:
      name: Preview track using cookies
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/tracks/:trackId/hls
      params:
      - name: trackId
        value: ''
        type: path
        description: Track id
    docs: "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.\
      \ \n\nThe 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, bas"
  - info:
      name: Similar tracks
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/tracks/:trackId/similar
      params:
      - name: trackId
        value: ''
        type: path
        description: Track id
      - name: offset
        value: ''
        type: query
        description: Index of the entry track in the response
      - name: limit
        value: ''
        type: query
        description: Max number of entries returned in the response, default 50 and max 60
    docs: '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.'
  - info:
      name: Similar track segment based on audio file
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/tracks/similar-sections
      params:
      - name: audioUploadId
        value: ''
        type: query
        description: Reference to the uploaded audio file
      - name: start
        value: ''
        type: query
        description: Start of the section in milliseconds
      - name: end
        value: ''
        type: query
        description: End of the section in milliseconds
      - name: offset
        value: ''
        type: query
        description: Index of the entry track in the response
      - name: limit
        value: ''
        type: query
        description: Max number of entries returned in the response, default 50 and max 100
    docs: Returns a list of track sections that are matched to the provided audio file id.
  - info:
      name: Similar track segment based on trackID
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/tracks/:trackId/similar-sections
      params:
      - name: trackId
        value: ''
        type: path
        description: Track id
      - name: start
        value: ''
        type: query
        description: Start of the section in milliseconds
      - name: end
        value: ''
        type: query
        description: End of the section in milliseconds
      - name: offset
        value: ''
        type: query
        description: Index of the entry track in the response
      - name: limit
        value: ''
        type: query
        description: Max number of entries returned in the response, default 50 and max 100
    docs: "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.\n\nThe feature utilizes the Epidemic Audio Reference (EAR) technology\
      \ to provide users with the ability to quickly find alternative segments of music.\n\nUsage Scenarios:\n\n  * Video\
      \ Editing Templates: Replace default tracks in video templates with segments that fit better.\n  * Quick Swaps: Swap\
      \ out a segment of music in a video where the"
  - info:
      name: Preview track
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/tracks/:trackId/stream
      params:
      - name: trackId
        value: ''
        type: path
        description: Track id
    docs: "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.\
      \ \n\nThe 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, bas"
  - info:
      name: Popular segment
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/tracks/:trackId/highlights
      params:
      - name: trackId
        value: ''
        type: path
        description: Track id
      - name: duration
        value: ''
        type: query
        description: The highlight duration in seconds
    docs: '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 le'
  - info:
      name: Tracks based on image
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/tracks/matching-image/:imageId
      params:
      - name: imageId
        value: ''
        type: path
        description: Image id
      - name: offset
        value: ''
        type: query
        description: Index of the entry track in the response
      - name: limit
        value: ''
        type: query
        description: Max number of entries returned in the response, default 50 and max 100
      - name: genre
        value: ''
        type: query
        description: Id for genre
      - name: mood
        value: ''
        type: query
        description: Id for mood
    docs: "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.\n "
- info:
    name: Beta
    type: folder
  items:
  - info:
      name: Beats
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/tracks/:trackId/beats
      params:
      - name: trackId
        value: ''
        type: path
        description: Track id
    docs: '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:  `t'
  - info:
      name: Start a track versions generation job
      type: http
    http:
      method: POST
      url: https://partner-content-api.epidemicsound.com/v0/tracks/versions
      body:
        type: json
        data: '{}'
    docs: "This endpoint allows you to start a job to generate edited versions of a track.\nThe job will be processed asynchronously\
      \ and you can check the status using the\nGET /tracks/versions/{jobId} endpoint. Note that the url expires in 24 hours.\
      \ \n\n**Duration limits:**\n- The duration must be between 1 second and 5 minutes. \n- Longer durations result in increased\
      \ processing time, as latency scales with the desired duration."
  - info:
      name: Get track versions job status
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/tracks/versions/:jobId
      params:
      - name: jobId
        value: ''
        type: path
        description: The ID of the job to check
      - name: expand
        value: ''
        type: query
        description: Include additional data in response. Use 'waveform' to include waveform data.
    docs: 'This endpoint allows you to check the status of a track versions job.

      When the job is complete, it will return the URLs to the generated tracks.


      **Waveform Data:**

      - By default, waveform data is excluded to reduce payload size

      - Use `expand=waveform` to include waveform data in the response'
- info:
    name: Assets
    type: folder
  items:
  - info:
      name: Get audio by checksum
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/uploads/audio/:checksum
      params:
      - name: checksum
        value: ''
        type: path
        description: File checksum
    docs: Will return the audio id of an audio file uploaded by the partner, matched by checksum. Should be used to avoid
      duplicate uploads
  - info:
      name: Delete audio
      type: http
    http:
      method: DELETE
      url: https://partner-content-api.epidemicsound.com/v0/uploads/audio/:audioIdOrChecksum
      params:
      - name: audioIdOrChecksum
        value: ''
        type: path
        description: Audio upload id or checksum of audio file
    docs: Use the delete audio endpoint to delete an audio file.
  - info:
      name: Upload audio
      type: http
    http:
      method: POST
      url: https://partner-content-api.epidemicsound.com/v0/uploads/audio
      body:
        type: multipart-form
        data:
        - name: file
          type: text
          value: ''
    docs: "Upload an audio file to get recommendations of similar tracks in the Epidemic Sound library. When you post the\
      \ audio file to this endpoint, you will receive an AudioID in return. Use this AudioID in a request to the similar tracks\
      \ endpoint to get track recommendations.\n \n We currently support the formats: mp3, mpeg, ogg and vorbis. Maximum file\
      \ size is 3.5MB. You can only upload music with the partner token, since we currently do not allow end users to use\
      \ this feature."
  - info:
      name: Delete single image
      type: http
    http:
      method: DELETE
      url: https://partner-content-api.epidemicsound.com/v0/uploads/images/:imageId
      params:
      - name: imageId
        value: ''
        type: path
        description: Image id
    docs: Use the delete image endpoint to delete a single image uploaded by a user
  - info:
      name: Upload image
      type: http
    http:
      method: POST
      url: https://partner-content-api.epidemicsound.com/v0/uploads/images
      body:
        type: multipart-form
        data:
        - name: file
          type: text
          value: ''
    docs: "Upload an image from the user's video to get recommendations of tracks in the Epidemic Sound library that would\
      \ work for the video. When you post the image to this endpoint, you will receive an ImageID in return. Use this ImageID\
      \ in a request to the matching image endpoint to get track recommendations.\n \n We currently support jpeg format and\
      \ maximum file size is 2MB."
  - info:
      name: Delete all the uploaded images by the user
      type: http
    http:
      method: DELETE
      url: https://partner-content-api.epidemicsound.com/v0/uploads/images
    docs: Deletes all images uploaded by the user
- info:
    name: Reporting
    type: folder
  items:
  - info:
      name: Report usage in bulk
      type: http
    http:
      method: POST
      url: https://partner-content-api.epidemicsound.com/v0/analytics/report
      body:
        type: json
        data: '{}'
    docs: "This endpoint should be used when you want to bulk report events to Epidemic Sound. We currently support the following\
      \ events:\ntrackPreviewed, trackDownloaded and tracksExported. Note that the limit for number of events per request\
      \ is limited to 100.\n Also note that for events containing the field trackIds, the limit for number of trackIds per\
      \ event is 50. \n Events may not contain a timestamp older than 7 days ago."
  - info:
      name: Report usage
      type: http
    http:
      method: POST
      url: https://partner-content-api.epidemicsound.com/v0/usage
      body:
        type: json
        data: '{}'
    docs: 'The usage endpoint lets you report when a user exports their content to social media or downloads the content file
      to their device.

      You can specify which platform (YouTube, Twitch, Instagram, Facebook, TikTok, Twitter or Other) they export the file
      to. Use the platform `local` if the user downloads the content to their device.

      This data is used for attribution and analytics purposes as well as to improve personalization.'
- info:
    name: Authentication
    type: folder
  items:
  - info:
      name: Request a partner token
      type: http
    http:
      method: POST
      url: https://partner-content-api.epidemicsound.com/v0/partner-token
      body:
        type: json
        data: '{}'
    docs: Request a Partner Token
  - info:
      name: Request a user token
      type: http
    http:
      method: POST
      url: https://partner-content-api.epidemicsound.com/v0/token
      body:
        type: json
        data: '{}'
    docs: 'Request a User Token. This endpoint requires a Partner Token for authentication. '
- info:
    name: Users
    type: folder
  items:
  - info:
      name: User details
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/users/me
    docs: Get user details of the authenticated user.
  - info:
      name: List users' liked tracks
      type: http
    http:
      method: GET
      url: https://partner-content-api.epidemicsound.com/v0/users/me/liked/tracks
      params:
      - name: offset
        value: ''
        type: query
        description: Offset for the pagination. For this endpoint the number of results is fixed at 25, so the offset needs
          to be evenly divisible by 25.
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://login.epidemicsound.com/auth/realms/accounts/protocol/openid-connect/auth
        accessTokenUrl: https://login.epidemicsound.com/auth/realms

# --- truncated at 32 KB (36 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/epidemic-sound/refs/heads/main/apis.yml