naftiko: 1.0.0-alpha2
info:
  label: Epidemic Sound Partner Content API — Browse & Search
  description: >-
    Browse and search the Epidemic Sound music catalog: collections, moods,
    genres, autosuggest, and full-text track search. Self-contained Naftiko
    capability covering the Browse & Search business surface of the Partner
    Content API.
  tags:
    - Epidemic Sound
    - Music
    - Search
    - Browse
  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: browse-and-search
      baseUri: https://partner-content-api.epidemicsound.com
      description: Browse and search the Epidemic Sound catalog (music).
      resources:
        - name: collections
          path: /v0/collections
          operations:
            - name: listCollections
              method: GET
              description: List curated music collections.
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: collection-by-id
          path: /v0/collections/{collectionId}
          operations:
            - name: getCollection
              method: GET
              description: Get a single collection by id.
              inputParameters:
                - name: collectionId
                  in: path
                  type: string
                  required: true
        - name: track-search
          path: /v0/tracks/search
          operations:
            - name: searchTracks
              method: GET
              description: Search music tracks by term, filters, mood, BPM, etc.
        - name: search-suggestions
          path: /v0/tracks/search/suggestions
          operations:
            - name: searchSuggestions
              method: GET
              description: Autosuggest completions for search terms.
        - name: moods
          path: /v0/moods
          operations:
            - name: listMoods
              method: GET
              description: List all moods in the catalog.
        - name: mood-by-id
          path: /v0/moods/{moodId}
          operations:
            - name: getMood
              method: GET
              description: Get mood details.
              inputParameters:
                - name: moodId
                  in: path
                  type: string
                  required: true
        - name: genres
          path: /v0/genres
          operations:
            - name: listGenres
              method: GET
              description: List all genres in the catalog.
        - name: genre-by-id
          path: /v0/genres/{genreId}
          operations:
            - name: getGenre
              method: GET
              description: Get genre details.
              inputParameters:
                - name: genreId
                  in: path
                  type: string
                  required: true
      authentication:
        type: apikey
        key: x-api-key
        value: '{{env.EPIDEMIC_SOUND_API_KEY}}'
        placement: header