Modern API docs for building with music data.
Explore structured metadata, audio features, lyrics, waveform data, artwork colors, and recommendation endpoints with a cleaner, implementation-ready reference.
Base URL
https://api.tune.dev/v1
Versioned REST surface for all public endpoints.
Authentication
Bearer token
Pass your Tune API key on every request.
Reliability
Stable IDs
All resources use durable Tune UUIDs.
Quick start
Make your first request
curl https://api.tune.dev/v1/tracks?limit=10 \
-H "Authorization: Bearer tune_live_sk_your_key" \
-H "Accept: application/json"What you can build
Common product patterns
Browse endpoint groups
Tracks
Tracks endpoints
Return a paginated list of tracks. Supports text search as well as filtering by artist, album, and explicit flag.
Fetch a single track by Tune ID.
Return recommended tracks based on one or more seed artists and/or genres. Pass either artist_ids, genres, or both.
Return acoustic and rhythmic feature signals for a track.
Return structural timing analysis for a track.
Return the full lyrics text for a track when available.
Return LLM-generated lyrical analysis and annotations for a track.
Return normalized waveform samples for rendering audio visualizations.
Return dominant artwork colors for a track.
Artists
Artists endpoints
Errors
Standard error envelope
| Status | Code | Description |
|---|---|---|
| 400 | bad_request | Invalid or malformed request parameters. |
| 401 | unauthorized | Missing or invalid API key. |
| 404 | not_found | Requested resource was not found. |
| 429 | rate_limited | Too many requests. Retry later. |
| 500 | internal_error | Unexpected server error. |
{
"error": {
"code": "not_found",
"message": "No track found with the provided tune_id",
"status": 404
}
}