Search songs
Searches the catalog by artist and title. Results are filtered by the requester's country, taken from the IP address. Responses are cached: 10 seconds for a search, 10 minutes for the popular list without a pattern.
Request
- Base URL: https://www.songsterr.com
- URL: https://www.songsterr.com/api/search
- Auth: none declared
Query parameters
Free text matched against artist and title. Up to 250 characters; a longer pattern returns no results. Without a pattern, songs are listed by popularity.
Only songs with an interactive player and a track of this instrument. Also ranks results by that instrument and picks defaultTrack among its tracks.
Only songs with a track in this tuning: comma-separated MIDI note numbers from the highest string, for example 64,59,55,50,45,40 for standard guitar tuning. Without inst, matches guitar and bass tracks.
Difficulty level of a track: 0 easy, 1 intermediate, 2 hard.
Order by the date of the latest revision instead of popularity.
Page size, 10 by default, at most 250; a larger value is rejected with 422. from + size is capped at 9999.
Offset of the first result, 0 by default.
Show (true) or hide (false) songs with explicit titles. By default they are hidden unless the pattern itself contains explicit words.
Ignored; kept for compatibility.
Ignored; kept for compatibility.
With track filters (inst, tuning, difficulty) on the first page, also report how many songs match the pattern without them in hasMoreWithoutFilters and additionalResultsCount.
Include view and favorite counters in each record.
Response
Default Response
Changes
No recorded changes to this operation across all 1 revision of this API.