POST /api/v1/analyze/url

Analyze audio by URL. Supported: YouTube, SoundCloud, TikTok, Beatstars, Traktrain, direct audio links.

Request body:

{
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "detect_bpm": true,
  "detect_key": true,
  "detect_hz": true
}

Field	Type	Required	Description
url	string	✅	Audio URL
detect_bpm	bool	❌	Detect BPM (default: true)
detect_key	bool	❌	Detect musical key (default: true)
detect_hz	bool	❌	Detect tuning frequency (default: true)

curl example:

curl -X POST https://lufs.space:8445/api/v1/analyze/url \
  -H "X-API-Key: lufs_your_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://soundcloud.com/artist/track"}'

Python example:

import requests

response = requests.post(
    "https://lufs.space:8445/api/v1/analyze/url",
    headers={"X-API-Key": "lufs_your_key"},
    json={"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}
)

data = response.json()
print(f"BPM: {data['bpm']}")
print(f"Key: {data['key']}")
print(f"Hz: {data['hz']}")

JavaScript (Node.js) example:

const response = await fetch("https://lufs.space:8445/api/v1/analyze/url", {
  method: "POST",
  headers: {
    "X-API-Key": "lufs_your_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    url: "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  }),
});

const data = await response.json();
console.log(`BPM: ${data.bpm}, Key: ${data.key}, Hz: ${data.hz}`);