> ## Documentation Index
> Fetch the complete documentation index at: https://heygen-1fa696a7.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Sound effects

> Search HeyGen's sound-effects catalog with natural language and get ready-to-use, pre-signed audio URLs for your videos via the HeyGen API.

![](https://mintcdn.com/heygen-1fa696a7/hfMXXwJzjE7vBSYZ/images/theme/research-5.webp?fit=max\&auto=format\&n=hfMXXwJzjE7vBSYZ\&q=85\&s=422da140ece4b799d490f85bb2013ca5)

Find sound effects by describing the moment you're scoring ("whoosh for a scene change", "cash register cha-ching", "soft notification chime") and get back ranked SFX, each with a pre-signed download URL. It's the same semantic search behind [background music](https://heygen-1fa696a7.mintlify.site/background-music.md): set `type=sound_effects` on `GET /v3/audio/sounds` and describe what you want in plain language.

## Search the Catalog

```bash theme={null}
curl -X GET "https://api.heygen.com/v3/audio/sounds?query=whoosh%20for%20a%20scene%20change&type=sound_effects&limit=3" \
  -H "x-api-key: YOUR_API_KEY"
```

Results come back with `type` `sound_effects`, and most effects are short, under a few seconds. Response fields, `limit`, `min_score` tuning, pagination with `token` and `next_token`, and the limited lifetime of each pre-signed `audio_url` all work as described on [Background music](https://heygen-1fa696a7.mintlify.site/background-music.md) and in the [reference](https://heygen-1fa696a7.mintlify.site/reference/search-audio-music-or-sound-effects.md).

> [!TIP]
>
> If your integration validates the `type` field in responses against an enum, add `sound_effects` to it. The [changelog entry](https://heygen-1fa696a7.mintlify.site/changelog.md) for this release has the full migration note.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.