POST /v1/identify

Identify a track from audio

Upload audio to identify the track via a multi-provider fingerprinting cascade. Returns artist, title, ISRC, and — if matched — free enrichment including BPM, key, genre, streaming platform IDs, and artwork. Synchronous; typical response 3-10 seconds. Charges 3 credits per request (cache hits are free).

Request Body

Content type: multipart/form-data · required

Example request

cURL
curl https://api.tunelab.dev/v1/identify \
  -H "Authorization: Bearer tl_live_xxx"

Responses

200 — Identification complete (matched or unmatched)

400 — Bad request (missing file, invalid audio, or audio under 3 seconds)

401 — Unauthorized

402 — Insufficient credits

413 — File exceeds tier upload limit (15 MB BASIC / 50 MB PRO)

429 — Rate limit exceeded

502 — All identification services unavailable

503 — Server overloaded — retry after backoff