AudioStack Assets - Sound Effects API
The Assets - Sound Effects API from AudioStack — 1 operation(s) for assets - sound effects.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/audiostack:audiostack-assets-sound-effects-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Audiostack Assets - Sound Effects API
description: Documentation for the Audiostack API - the infrastructure for audio
version: v2
termsOfService: https://audiostack.ai/en/legal/terms-of-service
contact:
email: support@audiostack.ai
servers:
- url: https://v2.api.audio
description: Production server
- url: https://staging-v2.api.audio
description: Staging server
security:
- ApiKeyAuth: []
- BearerAuth: []
tags:
- name: Assets - Sound Effects
paths:
/assets/sound-effects/query:
post:
tags:
- Assets - Sound Effects
summary: Search AudioStack's sound effect library for the right sound effect(s) for your…
description: 'Enables you to search AudioStack''s sound effects library from the API in a similar way to how you
would on the front end.
You can provide a search string e.g. "footsteps"
You can define a complex filter to narrow down the results such as:
Find all matches for
* `oneShot` sound effect types
* the `FIREWORKS` category
* duration less than or equal to `10`'
operationId: postSoundEffectsQuery
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/PostSoundEffectsQueryRequest'
responses:
'200':
description: Sound effects successfully queried
content:
application/json:
schema:
$ref: '#/components/schemas/PostSoundEffectsQueryResponse'
'422':
description: Invalid request cannot be processed
content:
application/json:
schema:
$ref: '#/components/schemas/PostSoundEffectsQueryUnprocessableEntityResponse'
components:
schemas:
GetStoryResponse:
allOf:
- type: object
properties:
meta:
type: object
properties:
requestId:
type: string
format: uuid
title: Request ID
version:
type: string
enum:
- '123'
default: '123'
deprecated: true
creditsUsed:
type: number
title: Credits used
default: 0
deprecated: true
creditsRemaining:
type: number
title: Credits remaining
default: 0
deprecated: true
warnings:
type: array
items:
type: string
default: []
title: Response warnings
required:
- meta
- warnings
- type: object
properties:
message:
type: string
description: Optional. When the job completed with an error, details the problem.
data:
type: object
properties:
storyId:
title: Story ID
type: string
format: uuid
example: 00000000-0000-0000-0000-000000000000
description: The unique identifier of the story creation request.
storyResult:
title: Story Result
description: The final story result (same shape as the Story type). Present when the job produced a story; may be absent or partial on failure.
$ref: '#/components/schemas/CreateStoryFromBodyRequest/properties/story'
audioforms:
title: Audioforms
type: array
description: List of generated audioforms when the job completed successfully. Each item is an AudioformResult. Optional; absent or partial on failure.
items:
anyOf:
- $ref: '#/components/schemas/AudioformResult3/properties/AudioformResult'
output:
title: Output
description: Audio output details when the job completed successfully. Present on success; absent on failure.
type: object
properties:
audioformUris:
title: Audioform URIs
type: array
description: List of delivery URIs for the individual audioforms.
items:
type: string
format: uri
public:
title: Public
type: boolean
description: Whether the generated audio files are publicly accessible.
singleAudioFileUri:
title: Single Audio File URI
type: string
format: uri
description: URI for a single merged audio file combining all audioforms.
extension:
type: string
title: Extension
enum:
- mp3
- wav
- ogg
- flac
- m4a
required:
- audioformUris
- public
- extension
additionalProperties: false
required:
- storyId
additionalProperties: false
required:
- data
- example:
meta:
version: '123'
requestId: 165e5b01-43b3-45df-b992-75af149f3c3d
creditsUsed: 10
creditsRemaining: 990
message: Story build completed successfully
warnings: []
data:
storyId: 0d694352-266c-4a62-b09f-4e910657af11
storyResult:
title: My Podcast
chapters: []
voices: []
sounds: {}
production: {}
delivery: {}
audioforms: []
output:
audioformUris:
- https://v2.api.audio/public-file/aaaaaaaa-0000-0000-0000-000000000001
- https://v2.api.audio/public-file/aaaaaaaa-0000-0000-0000-000000000002
public: true
singleAudioFileUri: https://v2.api.audio/public-file/aaaaaaaa-0000-0000-0000-000000000003
extension: mp3
additionalProperties: false
title: Get Story Response
SoundEffectResponse:
type: object
description: Sound effect item in the query response.
properties:
alias:
type: string
example: horse_coughing
title: Alias
description: 'The alias of the sound effect.
'
name:
type: string
example: Horse Coughing
title: Name
description: 'The name of the sound effect.
'
type:
example: public
title: Type
description: 'The type of the sound effect. All sound effects are currently `public`.
'
type: string
enum:
- public
duration:
type: number
format: float
example: 8.9
title: Duration in seconds
description: 'The duration of the sound effect in seconds.
'
audioSample:
type: string
format: uri
example: https://file.api.audio/sound-effect-samples/example.mp3
title: Audio sample
description: 'URL of the audio sample for the sound effect.
'
soundEffectType:
example: oneShot
$ref: '#/components/schemas/PostSoundEffectsQueryRequest/properties/filters/items/properties/in/oneOf/1/properties/soundEffectType/items'
description:
type: string
title: Description
description: 'Free text description of the sound effect.
'
example: A deep, throaty cough sound from a horse, suitable for equestrian scenes or animal soundscapes.
meta:
type: object
title: Metadata
description: 'Additional metadata for the sound effect.
'
properties:
category:
type: array
items:
type: string
title: Sound effect category (follows UCS categories)
description: Allowed values for sound effect category.
enum:
- AIR
- AIRCRAFT
- ALARMS
- AMBIENCE
- ANIMALS
- ARCHIVED
- BEEPS
- BELLS
- BIRDS
- BOATS
- BULLETS
- CARTOON
- CERAMICS
- CHAINS
- CHEMICALS
- CLOCKS
- CLOTH
- COMMUNICATIONS
- COMPUTERS
- CREATURES
- CROWDS
- DESIGNED
- DESTRUCTION
- DIRT & SAND
- DOORS
- DRAWERS
- ELECTRICITY
- EQUIPMENT
- EXPLOSIONS
- FARTS
- FIGHT
- FIRE
- FIREWORKS
- FOLEY
- FOOD & DRINK
- FOOTSTEPS
- GAMES
- GEOTHERMAL
- GLASS
- GORE
- GUNS
- HORNS
- HUMAN
- ICE
- LASERS
- LEATHER
- LIQUID & MUD
- MACHINES
- MAGIC
- MECHANICAL
- METAL
- MOTORS
- MOVEMENT
- MUSICAL
- NATURAL DISASTER
- OBJECTS
- PAPER
- PLASTIC
- RAIN
- ROBOTS
- ROCKS
- ROPE
- RUBBER
- SCIFI
- SNOW
- SPORTS
- SWOOSHES
- TOOLS
- TOYS
- TRAINS
- USER INTERFACE
- VEGETATION
- VEHICLES
- VOICES
- WATER
- WEAPONS
- WEATHER
- WHISTLES
- WIND
- WINDOWS
- WINGS
- WOOD
example:
- ANIMALS
subcategory:
type: array
items:
type: string
title: Sound effect subcategory (follows UCS subcategories)
description: Allowed values for sound effect subcategory.
enum:
- ACID
- ACTIVITY
- ADR
- AIR
- AIR BOAT
- AIR POWERED
- ALARM
- ALERT
- ALIEN
- ALPINE
- AMPHIBIAN
- AMUSEMENT
- ANGELIC
- ANGRY
- ANIMAL
- ANTIQUE
- APPLAUSE
- APPLIANCE
- AQUATIC
- ARC
- ARCADE
- ARMOR
- ARROW
- ARTILLERY
- ASSET
- ATV
- AUDIO VISUAL
- AUTOMATIC
- AVALANCHE
- AVIAN
- AXE
- BABY
- BAG
- BASS DIVE
- BAT
- BATTLE
- BEAM
- BEAST
- BEEP
- BELL
- BELLS
- BICYCLE
- BIRD
- BIRD OF PREY
- BIRDSONG
- BLOB
- BLOOD
- BLOW
- BLUNT
- BOARD
- BODYFALL
- BOING
- BONE
- BOOK
- BOOM
- BOUNCE
- BOW
- BOW WASH
- BRAAM
- BRAKE
- BRASS
- BREAK
- BREATH
- BRIDLE & TACK
- BUBBLES
- BURN
- BURNING
- BURP
- BURST
- BUS
- BUZZ & HUM
- BUZZER
- BY
- CABINET
- CAMERA
- CANNON
- CAR
- CASINO
- CAT DOMESTIC
- CAT WILD
- CELEBRATION
- CELLPHONE
- CHEER
- CHEERING
- CHILD
- CHILDREN
- CHIME
- CHORAL
- CLACK
- CLANG
- CLICK
- CLOCK
- CLOTH
- COIN
- COLLAPSE
- COMBUSTION
- COMMERCIAL
- COMPOSITE
- COMPUTER
- CONCRETE
- CONSTRUCTION
- CONTAINER
- CONVERSATION
- COOKING
- COUGH
- COURT
- COVERING
- CRACKLE
- CRASH & DEBRIS
- CREAK
- CREATURE
- CROW
- CROWD
- CRYING
- DATA
- DESERT
- DESIGNED
- DIESEL
- DINOSAUR
- DISTORTION
- DOG
- DOG WILD
- DOOR
- DOORBELL
- DRAGON
- DRAIN
- DRINKING
- DRIP
- DRONE
- DUNGEON
- DUST
- EARTHQUAKE
- EATING
- EERIE
- EFFORTS
- ELECTRIC
- ELECTROMAGNETIC
- ELECTRONIC
- ELEMENTAL
- ELEVATOR
- EMERGENCY
- ENERGY
- ESCALATOR
- ETHEREAL
- EVIL
- EXPERIMENTAL
- FAN
- FANTASY
- FARM
- FASHION
- FEET
- FEMALE
- FIELD
- FISHING
- FIZZ
- FLAP
- FLESH
- FLOW
- FLUTTER
- FOREST
- FOUNTAIN
- FOWL
- FREIGHT
- FRICTION
- FUMAROLE
- FURNITURE
- FUTZED
- GARDEN
- GAS
- GATE
- GEARS
- GENERAL
- GENERIC BY
- GEYSER
- GLASS
- GLASSWARE
- GLITCH
- GONG
- GRAB
- GRANULAR
- GRASS
- GRASSLAND
- GUN
- GUST
- GYM
- HAIL
- HAND
- HANDBELL
- HANDLE
- HANDS
- HARD DRIVE
- HARDWARE
- HEARTBEAT
- HELICOPTER
- HIGH SPEED
- HISS
- HISTORICAL
- HITECH
- HORN
- HORSE
- HOSPITAL
- HOUSEHOLD
- HUMAN
- HUMANOID
- HVAC
- HYDRAULIC & PNEUMATIC
- IGNITE
- IMPACT
- IMPULSE RESPONSE
- INDOOR
- INDUSTRIAL
- INGREDIENTS
- INSECT
- INSECTOID
- INSTRUMENT
- INTERIOR
- JALOPY
- JET
- JEWELRY
- KEYBOARD & MOUSE
- KEYED
- KEYS
- KISS
- KITCHENWARE
- KNIFE
- KNOCK
- LAKESIDE
- LAP
- LARGE
- LATCH
- LAUGH
- LAUGHTER
- LAVA
- LEAVES
- LEVER
- LOCK
- LOFI
- LOOP
- LOOP GROUP
- LUGGAGE
- MACHINE
- MALE
- MARKET
- MECHANICAL
- MECHANICS
- MECHANISM
- MEDICAL
- METAL
- MICROPHONE
- MILITARY
- MISC
- MIX
- MONSTER
- MORPH
- MOTION
- MOTORBOAT
- MOTORCYCLE
- MOVEMENT
- MUD POTS
- MUSICAL
- NAUTICAL
- OFFICE
- OOZE
- PACKAGING
- PANIC
- PARK
- PEE
- PERCUSSION
- PERCUSSION TUNED
- PERFORMANCE
- PFX
- PHONOGRAPH
- PISTOL
- PLASTIC
- PLUCK
- PLUCKED
- PLUMBING
- PNEUMATIC
- POLEARM
- POOF
- POP
- POUR
- POWER
- PRESENCE
- PRIMATE
- PRISON
- PRODUCTION
- PROP
- PROTEST
- PUBLIC PLACE
- PULLEY
- PUMP
- QUIET
- RACING
- RADIO
- RADIO CONTROLLED
- RATCHET
- RAW
- REACTION
- REAL
- RECREATIONAL
- REFERENCE
- RELAY
- RELIGIOUS
- REPTILE
- REPTILIAN
- RESIDENTIAL
- RESTAURANT & BAR
- RETRO
- REVOLVING
- RHYTHMIC
- RICOCHET
- RIFLE
- RIP
- RISER
- ROCKET
- RODENT
- ROLLER
- ROOM TONE
- ROWBOAT
- RUMBLE
- RURAL
- SAILBOAT
- SAMPLE
- SCENE
- SCHOOL
- SCIFI
- SCREAM
- SEA
- SEASIDE
- SERVO
- SHAKE
- SHAKEN
- SHELL
- SHIMMER
- SHIP
- SHOTGUN
- SIEGE
- SINGING
- SIREN
- SIZZLE
- SKATE
- SKID
- SKIN
- SLIDING
- SMALL
- SNEEZE
- SNIFF
- SNORE
- SONG & PHRASE
- SONGBIRD
- SOURCE
- SPACESHIP
- SPARKS
- SPELL
- SPIT
- SPLASH
- SPLAT
- SPORT
- SPRAY
- SQUEAK
- SQUISH
- STAB
- STATIC
- STEAM
- STINGER
- STONE
- STORM
- STRETCH
- STRINGED
- SUBMARINE
- SUBURBAN
- SUBWAY
- SUCTION
- SUPPRESSED
- SURF
- SUSPENSION
- SWAMP
- SWINGING
- SWISH
- SWITCH
- SWORD
- SYNTHESIZED
- SYNTHETIC
- TABLEWARE
- TACTICAL
- TAPE
- TELEMETRY
- TELEPHONE
- TELEVISION
- TEST TONE
- THUNDER
- TICK
- TIMER
- TIRE
- TONAL
- TORCH
- TORNADO
- TOWN
- TOY
- TRACK & FIELD
- TRADEMARKED
- TRADITIONAL
- TRAFFIC
- TRAM
- TRANSCEIVER
- TRANSPORTATION
- TREE
- TROPICAL
- TRUCK VAN & SUV
- TSUNAMI
- TUNDRA
- TURBINE
- TURBULENT
- TWANG
- TYPEWRITER
- TYPHOON
- UMBRELLA
- UNDERGROUND
- UNDERWATER
- URBAN
- UTILITY
- VEGETATION
- VEHICLE
- VIDEO
- VOCAL
- VOLCANO
- VOMIT
- WADING
- WAGON
- WALLA
- WARBLE
- WARFARE
- WATER
- WATERFALL
- WAVE
- WEAPON
- WHEELED
- WHIP
- WHISPER
- WHISTLE
- WHOOSH
- WILD
- WINDOW
- WINTER
- WOOD
- WOODWIND
- WORK IN PROGRESS
- WRITING
- WTF
- ZAP
- ZIP
- ZIPPER
example:
- HORSE
PostSoundEffectsQueryRequest:
type: object
description: Request body for sound effects query endpoint.
properties:
query:
type: string
default: ''
example: footsteps
title: Search query
description: 'Free text search query passed to the search engine. This is used to search for sound effects with some fuzzy matching.
'
filters:
type: array
title: Filters
description: 'Filters to apply. Each item is an object with one operator key (e.g. "in")
and a value object with one filter field and its values.
'
items:
type: object
title: Sound effects filter
description: Filter object for sound effect queries.
properties:
in:
oneOf:
- type: object
title: Alias filter
required:
- alias
additionalProperties: false
properties:
alias:
type: array
items:
type: string
title: Specify alias filter condition
description: 'Specify the alias filter condition. You can specify multiple accepted values by adding them to the array.
'
- type: object
title: Sound effect type filter
required:
- soundEffectType
additionalProperties: false
properties:
soundEffectType:
type: array
items:
type: string
title: Supported values for sound effect type
description: 'Types of sound effects available from the AudioStack sound effect library.
oneShot: A short, event-driven sound effect.
atmosphere: A longer, ambient background sound.
'
enum:
- oneShot
- atmosphere
title: Specify sound effect type filter condition
description: 'Specify the sound effect type filter condition. You can specify multiple accepted values (e.g. oneShot, atmosphere).
'
- type: object
title: Category filter
required:
- category
additionalProperties: false
properties:
category:
type: array
items:
$ref: '#/components/schemas/SoundEffectResponse/properties/meta/properties/category/items'
title: Specify category filter condition
description: 'Specify the UCS category filter condition. You can specify multiple accepted values by adding them to the array.
'
- type: object
title: Subcategory filter
required:
- subcategory
additionalProperties: false
properties:
subcategory:
type: array
items:
$ref: '#/components/schemas/SoundEffectResponse/properties/meta/properties/subcategory/items'
title: Specify subcategory filter condition
description: 'Specify the UCS subcategory filter condition. You can specify multiple accepted values by adding them to the array.
'
greaterThanOrEquals:
oneOf:
- type: object
title: Duration filter
required:
- duration
additionalProperties: false
properties:
duration:
type: number
title: Specify duration filter condition
description: 'Specify the duration filter condition as a float value.
'
lessThanOrEquals:
oneOf:
- type: object
title: Duration filter
required:
- duration
additionalProperties: false
properties:
duration:
type: number
title: Specify duration filter condition
description: 'Specify the duration filter condition as a float value.
'
example:
- in:
soundEffectType:
- oneShot
- in:
category:
- FIREWORKS
- lessThanOrEquals:
duration: 10
forceApplyFilters:
title: Force apply filters
type: boolean
default: true
description: 'When true, applies filters strictly even with few results. In instances where the filters
are overly restrictive, you may get fewer results than desired.
'
minimumNumberOfResults:
type: integer
default: 3
title: Minimum number of results
description: 'In instances where you want to ensure a minimum number of results, you can set this parameter.
You must also set forceApplyFilters to false. Filter conditions will be relaxed to attempt to
return the minimum number of results.
'
sort:
title: Sort field
$ref: '#/components/schemas/SoundEffectsSortValues'
page:
type: integer
minimum: 1
default: 1
title: Page number
description: Page number to return (1-indexed).
pageLimit:
type: integer
minimum: 1
default: 1000
title: Page limit
description: Number of items per page.
PostSoundEffectsQueryUnprocessableEntityResponse:
type: object
description: Error response when sound effect query fails (e.g. validation or search service error).
properties:
message:
type: string
example: '1 validation error for SoundEffectQueryPayload. Field required [type=missing, input_value={''soundEffectType'': [''invalid'']}, input_type=dict]'
errors:
type: array
example:
- Validation error
items:
type: string
PostSoundEffectsQueryResponse:
allOf:
- $ref: '#/components/schemas/GetStoryResponse/allOf/0'
- type: object
properties:
message:
type: string
description: Success message.
example: Fetched sound effects
data:
type: object
required:
- soundEffects
- pageInfo
properties:
soundEffects:
minItems: 0
type: array
items:
$ref: '#/components/schemas/SoundEffectResponse'
pageInfo:
$ref: '#/components/schemas/PostVoicesQueryResponse/allOf/1/properties/data/properties/pageInfo'
required:
- message
- data
PostVoicesQueryResponse:
allOf:
- $ref: '#/components/schemas/GetStoryResponse/allOf/0'
- type: object
properties:
message:
type: string
description: Success message.
example: Fetched voices
data:
type: object
required:
- voices
- pageInfo
properties:
voices:
minItems: 0
type: array
items:
$ref: '#/components/schemas/VoiceResponse'
pageInfo:
type: object
description: Pagination information for list endpoints.
properties:
page:
type: integer
description: Current page number (1-indexed).
pageItemsCount:
type: integer
description: Number of items on this page.
itemsTotal:
type: integer
description: Total number of items across all pages.
pagesTotal:
type: integer
description: Total number of pages.
pageLimit:
type: integer
description: Maximum items per page.
required:
- page
- pageItemsCount
- itemsTotal
- pagesTotal
- pageLimit
required:
- message
- data
SoundEffectsSortValues:
type: string
enum:
- alias
description: Field to sort results by. If omitted, results are sorted by AudioStack's internal sorting.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT