GET /v1/analyze

Analyze by metadata

Returns full audio features for a track identified by song + artist. Cache hits are free; misses trigger on-demand compute and charge credits.

Parameters

Name	In	Type	Required	Description
`song`	query	string	yes
`artist`	query	string	yes

Example request

curl https://api.tunelab.dev/v1/analyze \
  -G \
  --data-urlencode "song=Get Lucky" \
  --data-urlencode "artist=Daft Punk" \
  -H "Authorization: Bearer tl_live_xxx"

Responses

200 — Features returned

401 — Unauthorized

402 — Insufficient credits

404 — Track not found