tunebat.com APItunebat.com ↗
Retrieve BPM, musical key, Camelot notation, energy, danceability, and 9 audio features per track from Tunebat via a simple REST API.
curl -X GET 'https://api.parse.bot/scraper/6d01197e-814d-4b41-9a7c-406491e35d34/search_tracks?query=coldplay' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for music tracks on Tunebat by keyword (song name, artist, etc.). Returns a list of matching tracks with their IDs and URLs. The search query is case-insensitive.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g., 'Shape of You', 'coldplay', 'ed sheeran') |
{
"type": "object",
"fields": {
"count": "integer — number of results returned in this response",
"query": "string — the original search query",
"results": "array of objects with name, artist, track_id, url",
"total_available": "integer — total number of matching tracks available"
},
"sample": {
"data": {
"count": 50,
"query": "coldplay",
"results": [
{
"url": "https://tunebat.com/Info/1mea3bSkSGXuIRvnydlB5b",
"name": "Viva La Vida",
"artist": "Coldplay",
"track_id": "1mea3bSkSGXuIRvnydlB5b"
}
],
"total_available": 72
},
"status": "success"
}
}About the tunebat.com API
The Tunebat API exposes 2 endpoints that together cover music discovery and detailed audio analysis: use search_tracks to find songs by keyword and retrieve their Tunebat IDs, then call get_track_details to pull 9 quantified audio features — including energy, danceability, acousticness, and happiness — alongside BPM, musical key, Camelot notation, duration, album, and release date for any track.
Search and Identify Tracks
The search_tracks endpoint accepts a query string — song title, artist name, or any keyword — and returns a ranked list of matching tracks. Each result includes the track name, artist, track_id (which maps to the Spotify track ID), and a direct Tunebat url. The response also exposes total_available so you can gauge how many results exist beyond the current page.
Detailed Audio Features
Once you have a track_id or a full Tunebat URL, pass it to get_track_details. This endpoint returns the track's bpm, key (e.g. C♯ minor), camelot notation (e.g. 12A), and duration in mm:ss format. The features object contains nine normalized scores: energy, danceability, happiness, acousticness, instrumentalness, liveness, speechiness, loudness, and popularity. The additional_info object adds album name and release_date.
Camelot and Key for DJ and Production Workflows
The Camelot wheel value returned in camelot is particularly useful for harmonic mixing — it tells you which keys are compatible when building transitions. Combined with bpm, this makes the API directly applicable to setlist planning, DJ software integrations, or any workflow that needs both tempo and harmonic context without a separate key-detection step.
- Build a harmonic mixing tool using the
camelotandbpmfields to suggest compatible track transitions. - Enrich a music library database by batch-fetching
key,bpm, andrelease_datefor existing track IDs. - Power a playlist curator that filters by
energyanddanceabilityscores fromget_track_details. - Analyze mood across a catalog using
happinessandacousticnessfeatures to group tracks by emotional tone. - Integrate track audio features into a recommendation engine that clusters songs by
instrumentalnessandliveness. - Support music production research by comparing
loudnessandspeechinesstrends across release years. - Enable key-matching search in a songwriting app by combining
search_tracksresults with theirkeyandcamelotdata.
| 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 Tunebat have an official developer API?+
What exactly does `get_track_details` return beyond BPM and key?+
features object with nine scores — energy, danceability, happiness, acousticness, instrumentalness, liveness, speechiness, loudness, and popularity — plus camelot notation, duration in mm:ss, and an additional_info object containing album and release_date. The track_id field maps to the corresponding Spotify track ID.Can I retrieve chart rankings or streaming counts through this API?+
Can `search_tracks` return more results with pagination?+
total_available integer showing how many matching tracks exist, but the current endpoint does not expose a pagination parameter to fetch additional pages beyond the initial result set. You can fork the API on Parse and revise it to add offset or page parameters if deeper result sets are needed.Are the audio feature scores (energy, danceability, etc.) normalized values or raw numbers?+
features values reflect the scores as displayed on Tunebat, which are sourced from Spotify's audio analysis data and are normalized on a 0–1 scale (or percentage basis depending on field). The loudness field is typically expressed in decibels (dB) rather than a normalized score.