Create a textbox deep link
Send your users to Spotlistr with music and search settings already filled in. Your users can review the form before they start the search.
Choose a route
Start with the complete route for the service you want Spotlistr to search:
- Spotify:
/search/textbox/spotify
Add parameters
Add any of these query parameters. Names and values are case-sensitive. When a URL includes any textbox parameter, Spotlistr clears any saved textbox draft and uses the normal defaults for omitted values.
input- URL-encoded text, including multiple linesThe song titles, artists, links, or other text to add to the textbox.
searchTypetrackoralbumThe type of music to search for.searchModedefaultorisrcHow Spotlistr should read each line. ISRC works only with tracks.
Create the link
Use the built-in URL and URLSearchParams APIs in browsers and Node.js. These APIs correctly encode spaces, newlines, and reserved characters.
const url = new URL(
'/search/textbox/spotify',
'https://www.spotlistr.com',
);
const searchParams = new URLSearchParams({
input: [
'Massive Attack - Teardrop',
'Air - Venus',
].join('\n'),
searchType: 'track',
searchMode: 'default',
});
url.search = searchParams.toString();Generated URL
https://www.spotlistr.com/search/textbox/spotify?input=Massive+Attack+-+Teardrop%0AAir+-+Venus&searchType=track&searchMode=default