Tracks

Browse tracks

Discover tracks by filtering on label, artist, genre, or year. Returns up to 20 tracks ordered by release date (newest first) by default; pass randomize=true to sample 20 random tracks from the top-popularity pool instead. At least one filter parameter is required; calls with no filters return 400. Filter by genre with either genreId (a canonical id from GET /v1/genres) or genre (a free-text exact name). Prefer genreId as it is stable and unambiguous; use genre only to reach rare subgenres that /v1/genres does not list. genre and genreId are mutually exclusive; passing both returns 400.

Requires a paid plan: the free tier returns 403 for this endpoint.

get/v1/tracks/browse

Request

  • Base URL: https://api.sonovault.now
  • URL: https://api.sonovault.now/v1/tracks/browse
  • Auth: API key in header x-api-key

Query parameters

labelIdinteger

Filter by label ID.

artistIdinteger

Filter by artist ID.

genrestring

Exact genre name, case-insensitive (House matches House but not Tech House). Free-text alternative to genreId; use it for rare subgenres not listed by GET /v1/genres. Mutually exclusive with genreId.

genreIdinteger

Canonical genre id from GET /v1/genres, the stable, unambiguous way to filter by genre. Mutually exclusive with genre.

yearinteger

Release year (e.g. 2025).

randomizeboolean

If true, return 20 random tracks sampled from the top 1000 by popularity instead of the most recent releases. Defaults to false.

Response

Successful response

Changes

No recorded changes to this operation across all 1 revision of this API.