latestOpenAPI 3.1.02026-08-10202033.2 KB

d8deec5eca44

Search Tracks

Search for analyzed tracks with filtering options.

Parameters:

<b>x_api_key</b> : str (API key for authentication)<br> <b>genre</b> : str, optional (Filter by specific genre)<br> <b>limit</b> : int, default=50 (Maximum number of results, max 100)<br> <b>offset</b> : int, default=0 (Number of results to skip)<br> <b>filters</b> : AnalysisFilters, optional (Audio feature filters)<br>

Returns:

TrackIDList<br> List of matching track IDs<br>

Notes:

Supports pagination and complex audio feature filtering.

post/api/v1/tracks/search

Query parameters

genrestring nullable
limitinteger
offsetinteger

Headers

x-api-keystring

Request body

tempo_minnumber nullable
tempo_maxnumber nullable
energy_minnumber nullable
energy_maxnumber nullable
danceability_minnumber nullable
danceability_maxnumber nullable
valence_minnumber nullable
valence_maxnumber nullable
instrumentalness_minnumber nullable
instrumentalness_maxnumber nullable
acousticness_minnumber nullable
acousticness_maxnumber nullable
popularity_mininteger nullable
popularity_maxinteger nullable
keyinteger nullable
modeinteger nullable

Response

Successful Response

track_idsstring[] required