soundverse Capability
Copyright / Recognition
Identify a track and check it against known catalog matches.
Compat route available
GET /v5/recognize?audio_url=... covers copyright. audio_url is a required query param — omitting it returns 400 {"error": "MISSING_FIELD"}. See Compat Routes.
Behavior change from the old API
The old /v5/recognize was synchronous — it returned the match result directly. This route returns a job_id like every other endpoint; poll or stream for the result. The new gateway has no synchronous primitive to replicate the old behavior with.
Quickstart
GET/v5/recognize?audio_url=...compat route, simplest way to start
curl "https://apiv2.soundverse.ai/v5/recognize?audio_url=https://example.com/track.mp3" \
-H "Authorization: Bearer sksoundverse_..."copyright — native payload
POST/v1/generationstool_id for (model, "copyright")
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| song | file input | Yes | — | The track to identify / copyright-check. |
Response
Once the task completes, its output has this shape:
{
"matched": true,
"title": "Song Title",
"artist": "Artist Name",
"album": "Album Name",
"label": "Record Label",
"released": "2019-03-15",
"isrc": "USABC1234567",
"cover_url": "https://..."
}Pricing
| Version | Price |
|---|---|
| v5 | $0.03 |
USD flat price per check, regardless of license tier.