Skip to content
AINSOFAPI Get API key

GuidesFind similar

Find similar

Start from an AINSOF track and get others that sound like it. Mark a passage with from and to to match just that moment, such as the hook or the bar before the drop.

Along The River with a passage marked from 1:47 to 2:02, and three tracks with their matching passages

MCP toolfind_similarRESTaction: "similar"

Try it

curl https://mcp.ainsof.io/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AINSOF_API_KEY" \
  -d '{"action": "similar", "track_id": "AIN-CAT 030_001", "from": 107, "to": 122, "top_k": 5}'

What you send

track_idrequired
string
Cue id or title, e.g. AIN-CAT 030_001 or Along The River.
from
number
Start of the marked passage, in seconds from the start of the cue.
0 or more.
Also accepted as start
to
number
End of the marked passage, in seconds.
5 to 60 seconds after from.
Also accepted as end
top_k
integer
Number of results.
Default: 10
1 to 25.
Also accepted as count

Good to know

  • Send from and to to mark a passage (5 to 60 seconds long), for example the hook or the bar before the drop. Leave them out to compare whole cues.
  • Each result carries similarity and, for a passage, matching_passage: the part of that cue that sounds closest to the one you marked.
  • A passage that runs past the end of the cue is matched from its last seconds.
  • The cue you start from is never returned in its own results.
  • For a song by another artist (a YouTube, Spotify, Apple Music or Deezer link) use search with link instead.

Every field it returns, and its errors, in the API Reference