Search by video

Find Slipstream tracks that match a video's tone, pacing, and mood. The video is identified by the source_value returned from POST /api/v4/soundtrack/video/.

This endpoint is used inside the Soundtrack a video flow. Step 2 of the flow.

GET/api/v4/search/ai/by-video/

Query parameters

Parameter	Required	Description
`value`	Yes	A 32-char AIMS video hash, or a YouTube URL. Use the `source_value` from the SoundtrackVideo response.
`limit`, `offset`	No	Pagination.
Any filter parameter	No	Narrow by genre, mood, BPM, etc.

Example request — file-based video

curl "https://api.slipstreammusic.com/api/v4/search/ai/by-video/?value=5f3e7d9c8b2a4f1e6d0c5b8a3e2f7d9c&limit=20" \
  -H "Authorization: Bearer $PARTNER_API_KEY"

Example request — YouTube video

curl "https://api.slipstreammusic.com/api/v4/search/ai/by-video/?value=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ" \
  -H "Authorization: Bearer $PARTNER_API_KEY"

Example response

{
  "next": "?value=...&limit=20&offset=20",
  "previous": null,
  "results": [
    {
      "id": "1f3c4d5e-6a7b-8c9d-0e1f-2a3b4c5d6e7f",
      "name": "Cinematic Rise",
      "artist": { "name": "Jane Doe", "slug": "jane-doe" },
      "length": 142,
      "tempo": 128,
      "is_explicit": false,
      "is_free": true,
      "audio_url": "/api/v4/stream/1f3c4d5e-6a7b-8c9d-0e1f-2a3b4c5d6e7f/?type=track",
      "genre_name": "Cinematic",
      "mood_name": "Inspiring"
    }
  ]
}

See The Track object for the full field list.

Notes

Results are ranked by match score, best first.
The same value returns the same ranked list. Cache it client-side per session if you want users to refine filters without re-running the AI.
Filter parameters compose with the AI ranking: the AI orders by match, then your filters narrow the set.

Find similar tracks List filters