GuidesSearch by reference

Search by reference

Send a song by another artist, as a YouTube, Spotify, Apple Music or Deezer link or as artist - title, and get AINSOF tracks in that spirit.

MCP toolsearch_by_referenceRESTaction: "search"

Try it

curl https://mcp.ainsof.io/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $AINSOF_API_KEY" \
  -d '{"action": "search", "link": "Hans Zimmer - Time", "musical_styles": ["cinematic"]}'

What you send

linkrequired

string

Reference link, or artist - title.

musical_description

string

Known style, groove and instrumentation of the reference. Adds a second, text-based candidate search whose ranking is fused with the reference match. Negatives in it are enforced as in search. Translated when written in a non-Latin script.

At most 1000 characters.

musical_styles

string[]

Known English genre labels for the reference (e.g. disco, funk). Results are restricted to cues whose style tags match at least one label.

Up to 4 labels; each 1 to 80 characters of letters, digits, spaces, &, / and -, starting with a letter or digit.

top_k

integer

Number of results.

Default: 10

Capped at 25.

Also accepted as count

Good to know

Same action as search, with link instead of brief. If both are sent, the search runs on link.
Accepted references: a YouTube, Spotify, Apple Music or Deezer link, or artist - title. SoundCloud and TikTok links are not supported; send the artist and title instead.
Results are ranked candidates, not verified sound-alikes; reference_match.similarity_verified is always false.
The first reply may be 202 still_running; send the identical request again to continue the same search.
A link that cannot be resolved fails with 503 search_failed. Sending the same link again will not help; send artist - title instead.

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