POST /v1/audio-features

Batch audio features by IDs

Looks up audio features for up to 100 track IDs in a single call. Positional result: each slot in `audio_features` corresponds to the same index in the request `ids` array — `null` marks an ID that could not be resolved. Billing is per-slot via V2 sub-operations (not a flat route cost): resolved slots consume 2 credits each, null slots are refunded automatically. Use `?format=spotify` to receive Spotify-compatible per-element shape.

Parameters

NameInTypeRequiredDescription
format query string no Set to `spotify` for Spotify-parity per-element shape.

Request Body

Content type: application/json · required

Example request

cURL
curl https://api.brizm.dev/v1/audio-features \
  -H "Authorization: Bearer tl_live_xxx"

Responses

200 — Batch resolved (may contain null slots)

400 — Malformed batch request (missing `ids`, non-array, too many)

401 — Unauthorized

402 — Insufficient credits