Find similar tracks
Given a track ID, return tracks that sound similar. Use it to power "more like this" rows, related tracks on a track page, or alternate cuts when a first choice doesn't fit.
GET/api/v4/search/ai/by-id/
Query parameters
| Parameter | Required | Description |
|---|---|---|
track_id | Yes | A Slipstream track UUID, or an AIMS track ID (string). |
input_id_type | No | client (default) for Slipstream UUIDs, system for AIMS IDs. |
limit, offset | No | Pagination. |
bpm_range | No | BPM tolerance window. Default 5, max 100. |
prioritise_bpm | No | Boolean. BPM similarity outweighs other features. |
suppress_vocals | No | Boolean. Deprioritizes vocal tracks. |
highlights | No | Boolean. Include matching audio regions on each result. |
time_offset | No | Start position in the source track, in seconds. |
time_limit | No | Window length to analyze, in seconds. 1 to 60. |
| Any filter parameter | No | Narrow by genre, mood, BPM, etc. |
Example request
curl "https://api.slipstreammusic.com/api/v4/search/ai/by-id/?track_id=8a4b2c1d-9e7f-4a6b-b3c2-1f8d4e5a7c6b&limit=20" \
-H "Authorization: Bearer $PARTNER_API_KEY"Example response
{
"next": "?track_id=...&limit=20&offset=20",
"previous": null,
"results": [
{
"id": "1f3c4d5e-6a7b-8c9d-0e1f-2a3b4c5d6e7f",
"name": "Soft Light",
"artist": { "name": "Hint of Mint", "slug": "hint-of-mint" },
"length": 138,
"tempo": 124
}
]
}See The Track object for the full field list.