Endpoints

Interactive API endpoint reference for the Lotsofsounds sound effects API, with requests, schemas, and parameters

Browse the full API reference below. Each endpoint includes request parameters, response schemas, and code samples in cURL, JavaScript, Go, Python, Java, and C#.

Try it live

Each endpoint page has a Send button. Enter your API key and test requests directly from the docs.

Authentication

Most endpoints require an API key passed via the x-api-key header. Get your key, which requires a Pro or Enterprise plan.

Public endpoints

The Samples endpoints are free and require no authentication. Use them to explore the API before subscribing:

Terminal

curl https://api.lotsofsounds.com/api/v1/sounds/sample

Authenticated endpoints

Search, get details, and download sounds with your API key.

Query parameters

Parameter	Type	Description
`q`	string	Full-text search query (searches name and description)
`category`	string	Filter by sound category. Values: `SFX`, `MUSIC`, `LOFI`, `AMBIENT` (case-insensitive). A comma-separated list matches any of them.
`tags`	string	Filter by tags, comma-separated (AND logic). e.g. `nature,weather`
`min_duration`	number	Minimum duration in seconds
`max_duration`	number	Maximum duration in seconds
`sort`	string	Sort field: `downloads` (default), `created_at`, `duration`, or `name`
`order`	string	Sort direction: `asc` or `desc` (default)
`page`	integer	Page number (default `1`)
`limit`	integer	Results per page, max `100` (default `20`)

Examples

curl "https://api.lotsofsounds.com/api/v1/sounds?q=thunder&category=SFX&min_duration=1.0&max_duration=10.0&sort=duration&order=asc&limit=30" \
  -H "x-api-key: los_your_api_key_here"

const params = new URLSearchParams({
  q: "thunder",
  category: "SFX",
  min_duration: "1.0",
  max_duration: "10.0",
  sort: "duration",
  order: "asc",
  limit: "30",
});

const res = await fetch(
  `https://api.lotsofsounds.com/api/v1/sounds?${params}`,
  { headers: { "x-api-key": "los_your_api_key_here" } }
);
const { data, pagination } = await res.json();

import requests

res = requests.get(
    "https://api.lotsofsounds.com/api/v1/sounds",
    params={
        "q": "thunder",
        "category": "SFX",
        "min_duration": 1.0,
        "max_duration": 10.0,
        "sort": "duration",
        "order": "asc",
        "limit": 30,
    },
    headers={"x-api-key": "los_your_api_key_here"},
)
data = res.json()

Rate limits

Plan	Price	Requests/day	Downloads	API keys
Pro	$15/mo	2,500	Unlimited	2
Enterprise	$49/mo	50,000	Unlimited	20

See Authentication for details on rate limit headers and error handling.