API Reference

The Slipstream HTTP API. Versioned, JSON in and out, token-authenticated.

Base URL

https://api.slipstreammusic.com

Authentication

Most endpoints accept a partner API key sent as a bearer token:

Authorization: Bearer <PARTNER_API_KEY>

Specific endpoints may require additional headers (for example, X-User-ID when the call is made on behalf of one of your end users). The reference page for each endpoint lists every required header.

Conventions

• All requests and responses are JSON unless otherwise noted.
• Successful responses use HTTP 200; resources created with POST may return 201.
• Errors return a JSON body with a success: false flag plus an error object containing code and message. Codes are stable; messages are not — match against code in your client.
• Timestamps are ISO 8601 in UTC.
• IDs are UUIDs unless otherwise noted.

Resources

Search

Search the catalog by text, by reference URL, by track ID, or list available filters.

• GET /api/v4/search/ai/by-text/ — Search by natural-language query
• GET /api/v4/search/ai/by-url/ — Find similar tracks from a YouTube/Spotify/etc. URL
• GET /api/v4/search/ai/by-id/ — Find similar tracks from a Slipstream track
• GET /api/v4/search/ai/by-video/ — Find tracks that match an uploaded video or YouTube URL
• GET /api/v4/search/ai/filters/ — List available genres, moods, BPM ranges, and other filter values

Playlists

Manage user playlists. Owners and collaborators only.

• GET /api/v4/me/playlists/ — List playlists
• POST /api/v4/me/playlists/ — Create a playlist
• GET /api/v4/me/playlists/{slug}/ — Retrieve a playlist
• PATCH /api/v4/me/playlists/{slug}/ — Update a playlist
• DELETE /api/v4/me/playlists/{slug}/ — Delete a playlist
• POST /api/v4/me/playlists/{slug}/tracks/ — Add or remove items
• POST /api/v4/me/playlists/{slug}/tracks/reorder/ — Reorder items

Soundtrack a video

Score any video automatically. See the Soundtrack a video guide for the full flow.

• POST /api/v4/soundtrack/video/ — Upload a video or submit a YouTube URL
• GET /api/v4/soundtrack/video/{id}/ — Retrieve a video
• POST /api/v4/soundtrack/video/{id}/download/ — Render and download the video with a chosen track mixed in

Licenses

Issue licenses for Slipstream tracks on behalf of your end users.

• POST /api/v1/licenses/generate — Generate a license

More resources will be documented here as they're added.