Quickstart

Get from zero to your first API response in under 5 minutes. Create a free account to get an API key — no credit card required.

1. Get your API key

After signing up, your API key is available immediately on your dashboard. All requests must include your key in the x-api-key header.

2. Make your first request

curl https://api.sonovault.io/v1/tracks/search \
  -H "x-api-key: YOUR_API_KEY" \
  -G   -d "artist=Daft Punk" \
  -d "title=One More Time"

Authentication

All API requests require a valid API key passed in the x-api-key header.

x-api-key,: ,bvk_live_xxxxxxxxxxxxxxxxxx

Test keys prefixed bvk_test_ return mocked data. Live keys prefixed bvk_live_ hit the real database.

Rate limits

Rate limits are enforced per API key on a rolling 60-second window. If you exceed your limit, requests return 429 Too Many Requests.

Chart endpoints return up to 200 entries per call but count as one request against both the monthly quota and burst counter.

Rate limit headers are returned on every response: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset.

Errors

All errors follow a consistent JSON structure:

{
  "error": {
    "code": "not_found",
    "message": "No track found matching the provided parameters",
    "status": 404
  }
}