Search by URL
Find Slipstream tracks similar to a song you point to with a URL. Useful when a user already has a reference track on a streaming platform and wants something they can license.
GET/api/v4/search/ai/by-url/
Supported platforms: YouTube, Vimeo, Soundcloud, Spotify, Apple Music, TikTok.
Query parameters
| Parameter | Required | Description |
|---|---|---|
link | Yes | The reference song URL. Must be from a supported platform. |
limit, offset | No | Pagination. |
bpm_range | No | Tolerance window for BPM matching, in BPM. Default 5, max 100. |
prioritise_bpm | No | Boolean. When true, BPM similarity outweighs other features. |
suppress_vocals | No | Boolean. When true, deprioritizes vocal tracks. |
highlights | No | Boolean. Include matching audio regions in highlights. |
time_offset | No | Start position in the source audio, 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-url/?link=https%3A%2F%2Fopen.spotify.com%2Ftrack%2F1abc&limit=10&prioritise_bpm=true" \
-H "Authorization: Bearer $PARTNER_API_KEY"Example response
{
"next": "?link=...&limit=10&offset=10",
"previous": null,
"results": [
{
"id": "8a4b2c1d-9e7f-4a6b-b3c2-1f8d4e5a7c6b",
"name": "Cinematic Rise",
"artist": { "name": "Jane Doe", "slug": "jane-doe" },
"length": 142,
"tempo": 128,
"highlights": [
{ "start": 24.5, "end": 38.2, "score": 0.91 }
]
}
]
}See The Track object for the full field list.