Search sound effects

Search the sound effects catalog by free text, genre, and duration. Every parameter is optional — with none of them you get the catalog itself, in pages of 20.

GET/api/v4/search/soundfxs/

Query parameters

Parameter	Required	Description
`search`	No	Free text. Matched against name, description, and genre.
`genre_name`	No	Primary genre. Exact match — take the value from List filters.
`secondary_genre_name`	No	Second genre. Exact match, and independent of `genre_name` — not a sub-genre of it.
`length__range`	No	Duration in seconds as `<min>__<max>`, e.g. `length__range=10__60`. Both bounds are required.
`limit`, `offset`	No	Pagination. `limit` defaults to 20, max 100; `offset + limit` may not exceed 10000.

Example request

curl "https://api.slipstreammusic.com/api/v4/search/soundfxs/?search=rain&genre_name=Atmosphere&length__range=10__60&limit=20" \
  -H "Authorization: Bearer $PARTNER_API_KEY"

Example response

{
  "count": 412,
  "next": "https://api.slipstreammusic.com/api/v4/search/soundfxs/?search=rain&genre_name=Atmosphere&length__range=10__60&limit=20&offset=20",
  "previous": null,
  "results": [
    {
      "id": "3f0a7c52-1b64-4d9e-8f21-0c7a5e6b9d43",
      "slug": "rain-water-2",
      "name": "Rain, Water",
      "description": "Steady rain falling on open water.",
      "length": 49,
      "genre_name": "Atmosphere",
      "secondary_genre_name": "Rain",
      "audio_url": "https://...",
      "download_url": "https://..."
    }
  ]
}

Page by following next until it is null. count is the total number of matches, not how many you can page through — next goes null at 10000 results, which on a broad query is well before count.

See The sound effect object for the full field list.

Errors

HTTP	When
400	`length__range` is missing a bound, or `offset + limit` is over 10000
403	The API key is missing or unrecognised, or your account doesn’t have sound effects enabled
429	Rate limit or usage allowance exceeded. The response body says when it resets — back off until then rather than retrying

A genre that matches nothing is not an error: 200 with count: 0 and an empty results.

Overview List filters