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

Full-text search query (searches name and description)

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": "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"
    }
  ],
  "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"
}