Search sounds
Search and filter the full sound catalog. Supports full-text search, tag filtering, duration ranges, sorting, and pagination. Requires a **Pro** or **Enterprise** subscription.
Search and filter the full sound catalog. Supports full-text search, tag filtering, duration ranges, sorting, and pagination.
Requires a Pro or Enterprise subscription.
Authorization
apiKey x-api-key<token>
Your API key. Generate one from the dashboard.
Keys are prefixed with los_.
In: header
Query Parameters
q?string
Full-text search query (searches name and description)
tags?string
Comma-separated tags to filter by (AND logic)
min_duration?number
Minimum duration in seconds
max_duration?number
Maximum duration in seconds
sort?string
Field to sort by
Default
"name"Value in
"duration" | "name"order?string
Sort direction
Default
"desc"Value in
"asc" | "desc"page?integer
Page number
Default
1Range
1 <= valuelimit?integer
Results per page (max 100)
Default
20Range
1 <= value <= 100Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.lotsofsounds.com/api/v1/sounds?q=thunder&tags=nature%2Cweather&min_duration=1&max_duration=30"{
"data": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"name": "Thunder Rumble",
"description": "Deep rolling thunder with rain",
"tags": [
"nature",
"weather",
"thunder"
],
"duration": 12.5,
"stream_url": "http://example.com",
"download_url": "http://example.com",
"license": "CC0"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 342,
"totalPages": 18
}
}{
"error": "Missing x-api-key header"
}{
"error": "API access requires a Pro or Enterprise subscription",
"upgrade_url": "https://lotsofsounds.com/pricing"
}{
"error": "Rate limit exceeded",
"limit": 2500,
"reset": 1711411200
}{
"error": "Internal server error"
}