Search by text
Search the catalog with a natural-language query. The AI ranks results by tone, mood, and intent — not just keyword overlap. Best for prompts like "upbeat indie pop for a commercial" or "dark cinematic tension".
GET/api/v4/search/ai/by-text/
Query parameters
| Parameter | Required | Description |
|---|---|---|
text | Yes | The natural-language search query. |
limit, offset | No | Pagination. |
| Any filter parameter | No | Narrow results by genre, mood, BPM, etc. |
Example request
curl "https://api.slipstreammusic.com/api/v4/search/ai/by-text/?text=upbeat%20indie%20pop%20for%20a%20commercial&limit=10&genre=pop" \
-H "Authorization: Bearer $PARTNER_API_KEY"Example response
{
"next": "?text=upbeat+indie+pop+for+a+commercial&limit=10&offset=10",
"previous": null,
"results": [
{
"id": "8a4b2c1d-9e7f-4a6b-b3c2-1f8d4e5a7c6b",
"name": "Bright Mornings",
"artist": { "name": "Jane Doe", "slug": "jane-doe" },
"length": 142,
"tempo": 128,
"is_explicit": false,
"is_free": true,
"audio_url": "/api/v4/stream/8a4b2c1d-9e7f-4a6b-b3c2-1f8d4e5a7c6b/?type=track",
"genre_name": "Pop",
"subgenre_name": "Indie Pop",
"mood_name": "Uplifting",
"secondary_mood_name": "Energetic",
"vocals": "Female Vocals",
"has_stems": true,
"cover": "https://...",
"release_date": "2025-09-12",
"short_url": "https://slipstreammusic.com/t/...",
"restricted": false,
"highlights": []
}
],
"did_you_mean": null,
"playlist_search": { "ids": [] }
}See The Track object for the full field list.
Extras returned with text search
| Field | Description |
|---|---|
did_you_mean | Spelling suggestions when filter values look like typos (e.g., genre=rok → suggests rock). null when nothing to suggest. |
playlist_search.ids | Public playlists that contain a high overlap of result tracks. Useful for showing "found in these playlists" context. |