GET /v1/audio-features/{id}

Audio features by track ID

Returns audio features for a track identified by any supported ID form — Spotify ID, MusicBrainz ID (MBID), ISRC, Apple Music ID, Deezer ID, or YouTube ID. Cache hits are free; misses trigger on-demand compute and charge 2 credits. Use `?format=spotify` to receive Spotify-compatible shape (0.0-1.0 floats, pitch-class integer key, Spotify field names). See guides/replacing-spotipy-python.

Parameters

NameInTypeRequiredDescription
id path string yes
format query string no Set to `spotify` for Spotify-parity output shape.

Example request

cURL
curl https://api.brizm.dev/v1/audio-features/{id} \
  -G \
  --data-urlencode "format=<value>" \
  -H "Authorization: Bearer tl_live_xxx"

Responses

200 — Features returned

401 — Unauthorized

402 — Insufficient credits

404 — Track not found