Audio Similarity Search

Find tracks in your library that sound similar to a reference audio.

Find Similar Tracks in Library

Find similar tracks within your library.

GET /api/v1/tracks/{track_id}/similar-audio

curl

curl "https://api.songpot.space/api/v1/tracks/abc123/similar-audio?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

Python

import requests

response = requests.get(
    f"https://api.songpot.space/api/v1/tracks/{track_id}/similar-audio",
    params={"limit": 10},
    headers={"X-API-Key": API_KEY}
)

similar = response.json()["similar_tracks"]

JavaScript

const response = await fetch(
  `https://api.songpot.space/api/v1/tracks/${trackId}/similar-audio?limit=10`,
  { headers: { 'X-API-Key': API_KEY } }
);

const { similar_tracks } = await response.json();

Query Parameters

Parameter	Type	Default	Description
limit	number	10	Max results (1-50)

Response

{
  "track_id": "abc123",
  "similar_tracks": [
    {
      "id": "def456",
      "name": "Similar Vibe",
      "duration": 195.0,
      "bpm": 126.0,
      "key": "aMinor",
      "similarity": 0.92
    }
  ],
  "total": 8
}

---

Search by Audio File

Upload an audio file to find similar tracks in your library.

POST /api/v1/search-by-audio

curl

curl -X POST "https://api.songpot.space/api/v1/search-by-audio?limit=20" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@reference.mp3"

Python

response = requests.post(
    "https://api.songpot.space/api/v1/search-by-audio",
    files={"file": open("reference.mp3", "rb")},
    params={"limit": 20},
    headers={"X-API-Key": API_KEY}
)

similar = response.json()["similar_tracks"]

JavaScript

const formData = new FormData();
formData.append('file', audioFile);

const response = await fetch(
  'https://api.songpot.space/api/v1/search-by-audio?limit=20',
  {
    method: 'POST',
    headers: { 'X-API-Key': API_KEY },
    body: formData
  }
);

const { similar_tracks } = await response.json();

Query Parameters

Parameter	Type	Default	Description
limit	number	20	Max results (1-50)

Response

{
  "query_file": "reference.mp3",
  "similar_tracks": [
    {
      "id": "abc123",
      "name": "Similar Track",
      "duration": 180.0,
      "bpm": 128.0,
      "key": "aMinor",
      "similarity": 0.85
    }
  ],
  "total": 10
}

Supported Audio Formats

MP3, WAV, FLAC, OGG, M4A, AAC (max 150MB)

---

Similarity Scores

Score	Meaning
0.9+	Very similar
0.7-0.9	Clearly similar style
0.5-0.7	Related but distinct