List sample sounds

Returns up to 12 sample sounds with optional search. This endpoint is **public** and requires no authentication. Use it to explore the response format before subscribing.

PostmanPostman Collection
GET
/api/v1/sounds/sample

Returns up to 12 sample sounds with optional search. This endpoint is public and requires no authentication. Use it to explore the response format before subscribing.

Query Parameters

q?string

Case-insensitive keyword search. Each word must match the sound name, description or a tag, so "card shuffle" finds sounds that contain both words. Use short keywords such as "whoosh" or "rain".

tags?string

Comma-separated tags to filter by (OR logic)

limit?integer

Max results (capped at 12)

Default12
Range1 <= value <= 12

Response Body

application/json

application/json

curl -X GET "https://api.lotsofsounds.com/api/v1/sounds/sample?q=thunder&tags=nature%2Cweather"
{
  "data": [
    {
      "id": "fs-398576",
      "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"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 342,
    "totalPages": 18
  },
  "meta": {
    "message": "These are sample sounds. Sign up for full catalog access.",
    "upgrade_url": "https://lotsofsounds.com/pricing"
  }
}
{
  "error": "Internal server error"
}