latestOpenAPI 3.1.02026-08-10202033.2 KB

d8deec5eca44

Get Beat Structure Recommendations

Get recommendations for tracks with specific beat structure characteristics.

Parameters:

<b>params</b> : BeatStructureParams<br> - min_regularity: float, default=0.7 (Minimum beat regularity score 0-1)<br> - tempo_min: float, optional (Minimum tempo in BPM)<br> - tempo_max: float, optional (Maximum tempo in BPM)<br> - genre: str, optional (Specific genre filter)<br> - limit: int, default=20 (Number of recommendations)<br> <b>x_api_key</b> : str (API key for authentication)<br>

Returns:

TrackIDList<br> List of recommended track IDs matching beat structure criteria<br>

Notes:

Useful for finding tracks with consistent, predictable beat patterns.

post/api/v1/recommendations/beat-structure

Headers

x-api-keystring

Request body

min_regularitynumber

Minimum beat regularity (0-1)

tempo_minnumber nullable

Minimum tempo (BPM)

tempo_maxnumber nullable

Maximum tempo (BPM)

genrestring nullable

Optional genre filter

limitinteger

Number of recommendations

Response

Successful Response

track_idsstring[] required