Beatlyze Audio analysis API

Reference

Current public endpoint surface.

This page mirrors the live API shape at a glance. For exact schemas, download the OpenAPI document.

Anonymous demo

POST /v1/demo/analyze/url

Submit a public audio URL without signup and receive a token-gated demo poll URL.

Registration

POST /v1/auth/register

Create a free account, generate an API key, and create the Stripe customer record used for upgrades.

Verification

POST /v1/auth/verify-email

Activate protected routes for email-verification-enabled environments.

Upload

POST /v1/analyze/upload

Multipart upload flow for local files. Returns job_id first, then poll the result.

URL analysis

POST /v1/analyze/url

Submit a signed-in public audio URL with the same async result lifecycle as uploads.

Batch

POST /v1/analyze/batch

Send up to ten URL items in one request for webhook-first ingestion flows.

Polling

GET /v1/analysis/{job_id}

Retrieve the completed result, in-progress status, or terminal error for a signed-in job.

Full result

GET /v1/analysis/{job_id}/full

Return the full analysis payload including section-level data for section-aware integrations.

Webhook log

GET /v1/analysis/{job_id}/webhooks

Inspect outbound webhook delivery attempts, status codes, and error details for that job.

Usage

GET /v1/usage

Current month, limit, count, and remaining analyses for the active API key.

Billing

GET /v1/billing/status

Tier, meter state, portal availability, and verification state for the active account.

Links

Download the exact machine-readable contract.