x-minus.pro APIx-minus.pro ↗
Search karaoke backing tracks, retrieve full lyrics and file details, and fetch the top 50 charts from X-Minus.pro via a clean REST API.
curl -X GET 'https://api.parse.bot/scraper/fab46e26-af25-40da-b33d-cf320a873349/search_tracks' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for karaoke backing tracks by song name or artist name. Returns matching artists and tracks with metadata including duration, bitrate, and track type.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search query - can be a song name, artist name, or keywords. |
{
"type": "object",
"fields": {
"query": "string",
"tracks": "array of track objects with id, title, artist, duration, url, and info",
"artists": "array of matching artist objects with name and url",
"total_tracks": "integer"
},
"sample": {
"query": "Adele",
"tracks": [
{
"id": "147",
"url": "https://x-minus.pro/track/147/theres-a-fire-starting-in-my",
"info": "242 kbps arrang + b.v.",
"title": "Rolling in the Deep",
"artist": "Adele",
"duration": "3:50"
}
],
"artists": [
{
"url": "https://x-minus.pro/artist/adele",
"name": "Adele"
}
],
"total_tracks": 50
}
}About the x-minus.pro API
The X-Minus.pro API exposes 3 endpoints for searching, retrieving, and ranking karaoke instrumental tracks. The search_tracks endpoint accepts a song name or artist query and returns matched tracks with duration, bitrate, and direct URL, while get_track delivers per-track metadata including full lyrics, file size, rating, and upload date. A third endpoint surfaces the site's current top 50 most-played backing tracks with no inputs required.
Search and Track Discovery
The search_tracks endpoint accepts a query string — artist name, song title, or keywords — and returns two parallel arrays: a tracks array and an artists array. Each track object includes id, title, artist, duration, url, and an info field. The total_tracks integer tells you how many matches were found. Artist objects include name and url for further lookup. Both the numeric id and the URL slug from the url field are needed to call get_track.
Detailed Track Data and Lyrics
get_track requires two inputs extracted from search_tracks results: track_id (the numeric ID, e.g. 23315) and slug (the URL path segment, e.g. killer-queen). The response adds fields not available in search results: lyrics (full song text), likes, rating (all-time score), uploaded (date string), file_size (with bitrate), and a type field describing the track format. A related_tracks set is also returned for navigation between similar recordings.
Top Charts
get_top_tracks requires no parameters and returns a ranked list of up to 50 currently popular backing tracks, each carrying the same id, title, artist, duration, url, and info fields as search results. The total field confirms how many entries were returned. This endpoint is useful for building trending dashboards or seeding a catalog without a specific query.
- Build a karaoke app that searches tracks by song title and displays lyrics from the
lyricsfield during playback - Populate a backing-track catalog by iterating
get_top_tracksresults to seed a database with popular instrumentals - Display track metadata cards showing
duration,file_size,bitrate, andratingalongside each search result - Create artist-focused pages by filtering
search_tracksresults byartistand linking out via the returnedurl - Monitor chart movement by periodically calling
get_top_tracksand comparing ranked position over time - Feed a recommendation engine using
related_tracksdata returned byget_trackfor a given song
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does X-Minus.pro offer an official developer API?+
What does `get_track` return beyond what `search_tracks` already provides?+
get_track adds fields not present in search results: full lyrics, likes count, all-time rating, uploaded date, and file_size with bitrate. It also returns a type field indicating the track format. Both the track_id and slug from a search_tracks result are required inputs.Can I retrieve more than 50 tracks from the top charts, or paginate through results?+
get_top_tracks returns a fixed list of up to 50 tracks with no pagination parameters. search_tracks also returns results without a built-in page/offset input. You can fork this API on Parse and revise it to add pagination or deeper chart coverage if your use case requires it.Does the API expose audio file download URLs for the backing tracks?+
url field pointing to the track's page and an info field, but direct audio file download URLs are not currently a returned field. You can fork this API on Parse and revise it to add direct file URL extraction to the response.Is the `lyrics` field always populated?+
lyrics field is returned by get_track, but availability depends on whether lyrics have been associated with that specific track on X-Minus.pro. Not all tracks on the site have lyrics attached, so the field may be empty or absent for some entries.