---
title: "Search and filter sound effects"
method: GET
path: "/v1/sound-effects"
tags: ["Sound Effects"]
---

# Search and filter sound effects

`GET /v1/sound-effects`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/sound-effects`
- Auth: API key in header `x-magnific-api-key`

Search the Magnific Sound Effects catalog. Filter by category, duration range, premium status, and creation date. Returns paginated results sorted by popularity by default.

## Query parameters

- `q` string
- `category` 'ambience' | 'forest' | 'city-ambience' | 'room-tones' | 'rain-and-storm' | 'beach-and-ocean' | 'wind' | 'foley' | 'weapons-and-warfare' | 'footsteps' | 'explosions-and-crashes' | 'kicks-and-punches' | 'clothing' | 'debris' | 'human-sounds' | 'genre' | 'glitch-and-noise' | 'cartoon-voices-and-sounds' | 'sci-fi-sounds' | 'ghosts-and-horror-transitions' | 'gaming-and-fantasy' | 'interface-and-alerts' | 'user-interface' | 'musical' | 'drum-and-percussion-loops' | 'vocal-phrases' | 'one-shots' | 'melodic-loops' | 'realistic' | 'wildlife' | 'machines-and-tools' | 'household-objects' | 'cars-and-airplanes' | 'water' | 'electronic-devices' | 'pets-and-farm-animals' | 'transitions' | 'epic-transitions' | 'cinematic-impacts' | 'whooshes' | 'risers' | 'intros-and-outros'
- `include-premium` boolean
- `order_by` 'relevance' | 'popularity' | '-popularity' | 'download_count' | '-download_count' | 'created_at' | '-created_at' | 'duration' | '-duration' | 'title' | '-title'
- `limit` integer
- `offset` integer

## Response `200`

OK

- PaginatedSfxListResponse
  - `count` integer, required: Total number of results matching the query
  - `results` SfxListItem[], required
    - `id` integer, required: Unique identifier of the sound effect
    - `title` string, required: Sound effect title
    - `tags` string[]: Tags associated with the sound effect
    - `category` SfxCategory: Category of the sound effect, with optional parent category
      - `id` integer, required: Category identifier
      - `name` string, required: Category name
      - `parent` SfxCategoryParent, nullable: Parent category, if this is a subcategory
        - `id` integer, required
        - `name` string, required
    - `duration` number, float: Duration in seconds
    - `is_premium` boolean: Whether the sound effect is premium
    - `popularity` integer: Popularity score
    - `download_count` integer: Total number of downloads
    - `file_url` string, nullable: Direct CDN URL to the audio file
    - `created_at` string, date-time: Creation timestamp

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)