naftiko: 1.0.0-alpha2
info:
  label: Epidemic Sound Partner Content API — Sound Effects
  description: >-
    Browse, search, and download from the Epidemic Sound sound effects
    library — 250,000+ SFX across categorized collections.
  tags:
    - Epidemic Sound
    - Sound Effects
    - SFX
    - Audio
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
  - namespace: env
    keys:
      EPIDEMIC_SOUND_API_KEY: EPIDEMIC_SOUND_API_KEY
capability:
  consumes:
    - type: http
      namespace: sound-effects
      baseUri: https://partner-content-api.epidemicsound.com
      description: Sound effects browse, search, and download.
      resources:
        - name: sfx-collections
          path: /v0/sound-effects/collections
          operations:
            - name: listSfxCollections
              method: GET
              description: List sound-effect collections.
        - name: sfx-collection
          path: /v0/sound-effects/collections/{collectionId}
          operations:
            - name: getSfxCollection
              method: GET
              description: Get a sound-effect collection by id.
              inputParameters:
                - name: collectionId
                  in: path
                  type: string
                  required: true
        - name: sfx-categories
          path: /v0/sound-effects/categories
          operations:
            - name: listSfxCategories
              method: GET
              description: List SFX categories.
        - name: sfx-category
          path: /v0/sound-effects/categories/{categoryId}
          operations:
            - name: getSfxCategory
              method: GET
              description: Get SFX category details.
              inputParameters:
                - name: categoryId
                  in: path
                  type: string
                  required: true
        - name: sfx-category-tracks
          path: /v0/sound-effects/categories/{categoryId}/tracks
          operations:
            - name: listSfxCategoryTracks
              method: GET
              description: List sound effects within a category.
              inputParameters:
                - name: categoryId
                  in: path
                  type: string
                  required: true
        - name: sfx-search
          path: /v0/sound-effects/search
          operations:
            - name: searchSfx
              method: GET
              description: Search the sound effects library.
        - name: sfx-download
          path: /v0/sound-effects/{trackId}/download
          operations:
            - name: downloadSfx
              method: GET
              description: Download a sound effect.
              inputParameters:
                - name: trackId
                  in: path
                  type: string
                  required: true
      authentication:
        type: apikey
        key: x-api-key
        value: '{{env.EPIDEMIC_SOUND_API_KEY}}'
        placement: header