Recognize Song - v5 - Soundverse

🚀 apiv2 is live!

Soundverse’s Enterprise API has moved to apiv2.soundverse.ai — new self-serve account setup, API keys, and billing are managed at platform.soundverse.ai. This page documents the legacy api.soundverse.ai API.

Recognize Song (v5)

Endpoint

/v5/recognize

Behavior & Priority

The endpoint accepts one of the following inputs (priority order):

file (multipart upload)
audio_url (query string)
raw audio bytes in the request body

If none are provided, the API returns a 400 error.

Request Parameters

Parameter	Type	Location	Description	Required	Default
`audio_url`	string	query	Remote audio file URL	No	N/A
`file`	file	multipart/form-data	Audio file upload	No	N/A
(raw body)	bytes	body	Raw audio bytes (e.g., `audio/mpeg`)	No	N/A

🛈 For audio_url, the server downloads up to 25 MB and may wait up to 120 seconds for slow sources.

Response

Shape

{
  "recognized": true,
  "data": {
    "artist": "ROMA",
    "title": "POTETO CHIP",
    "album_art": "https://api.soundverse.ai/blob/...",
    "album_name": "POTETO CHIP - Single",
    "label": "Doodoo Records",
    "released": "2025",
    "albumadamid": "1846981767",
    "isrc": "QT3FE2571493"
  }
}

Fields

Field	Type	Description
`recognized`	bool	`true` if a match was found
`data`	`Response` \| null	Recognized track data (null if no match)

Response

Field	Type	Description
`artist`	string \| null	Artist name
`title`	string \| null	Track title
`album_art`	string \| null	Album art URL
`album_name`	string \| null	Album name
`label`	string \| null	Label name
`released`	string \| null	Release year
`albumadamid`	string \| null	album ID
`isrc`	string \| null	ISRC code

Example Requests

import requests

url = "https://api.soundverse.ai/v5/recognize"
headers = {"Authorization": "Bearer your_api_key_here"}
params = {"audio_url": "https://storage.soundverse.ai/.../audio.mp3"}

response = requests.get(url, headers=headers, params=params)
print(response.json())

import requests

url = "https://api.soundverse.ai/v5/recognize"
headers = {"Authorization": "Bearer your_api_key_here"}
files = {"file": ("audio.mp3", open("audio.mp3", "rb"), "audio/mpeg")}

response = requests.get(url, headers=headers, files=files)
print(response.json())

const url = new URL("https://api.soundverse.ai/v5/recognize");
url.searchParams.set("audio_url", "https://storage.soundverse.ai/.../audio.mp3");

const response = await fetch(url, {
  method: "GET",
  headers: { Authorization: "Bearer your_api_key_here" },
});

console.log(await response.json());

const form = new FormData();
form.append("file", fileInput.files[0]);

const response = await fetch("https://api.soundverse.ai/v5/recognize", {
  method: "GET",
  headers: { Authorization: "Bearer your_api_key_here" },
  body: form,
});

console.log(await response.json());

curl -G "https://api.soundverse.ai/v5/recognize" \
  -H "Authorization: Bearer your_api_key_here" \
  --data-urlencode "audio_url=https://storage.soundverse.ai/.../audio.mp3"

curl -X GET "https://api.soundverse.ai/v5/recognize" \
  -H "Authorization: Bearer your_api_key_here" \
  -F "file=@audio.mp3;type=audio/mpeg"

curl -X GET "https://api.soundverse.ai/v5/recognize" \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: audio/mpeg" \
  --data-binary "@audio.mp3"

No Match Example

{
  "recognized": false,
  "data": null
}

Possible Errors

Missing Input (400)

{
  "detail": "Provide audio_url, file, or raw body bytes"
}

Client Disconnected (499)

{
  "detail": "Client disconnected"
}

Server Error (500)

{
  "detail": "Unexpected error message"
}

Get Started

Frequently Asked Questions

Creating with Soundverse

Exploring Soundverse

Account Management

Enterprise Platform

API Documentation

Recognize Song - v5

🚀 apiv2 is live!

Recognize Song (v5)

Endpoint

Behavior & Priority

Request Parameters

Response

Example Requests

No Match Example

Possible Errors

🚀 apiv2 is live!

​Recognize Song (v5)

​Endpoint

​Behavior & Priority

​Request Parameters

​Response

​Example Requests

​No Match Example

​Possible Errors

Recognize Song (v5)

Endpoint

Behavior & Priority

Request Parameters

Response

Example Requests

No Match Example

Possible Errors