Basic Information

appmixer.spotify.core.FindTracks

Find Tracks

1.0.0

Public

Search the Spotify catalogue for tracks and score how well each result matches the requested artist and title. Built for hand-typed tracklists: typos, "ft"/"+" collaborators and "/four tet rmx" version suffixes still match. Results below the minimum score leave through the Not Found port.

Input Ports

in

FieldTypeDescription
Artist text The performing artist, as written in your source. Collaborators may be separated by ft, feat., &, +, , or x - only the first one is matched. Fill Artist and Title together to get match scoring.
Title text The song title. A version suffix such as /four tet rmx, (Radio Edit) or - Live is understood and matched separately from the song itself.
Search Query text Free-text search, used when Artist and Title are not both filled in. With free text the score compares the whole query against the candidate, so the structured fields give better matches.
Minimum Match Score number Between 0 and 1. Results scoring below this are dropped; when nothing is left, the input is emitted on the Not Found port. 0.75 accepts a typo or two, 0.9 is close to exact.
Maximum Results number How many candidates to score, 1 to 50. Spotify serves 10 per page, so 50 costs five API calls against the rolling rate-limit window.
Market text Optional ISO 3166-1 alpha-2 country code (e.g. CZ) to restrict results to tracks available in that market.
Output Type select Choose whether you want to receive the result set as one complete list, first item only, one item at a time, or stream the items to a file. Building a playlist from a tracklist usually wants "First Item Only" - the best-scoring match.

Output Ports

out

notFound

FieldTypeDescription
Search Query string -
Artist string -
Title string -
Minimum Match Score number -
Candidates Scored integer -

Full Metadata