Endpoints

Interactive API endpoint reference for the Lotsofsounds sound effects API — try requests, view schemas, and explore 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 — 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)
`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: `created_at` (default), `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.