Skip to main content

🚀 apiv2 is live!

Trace is served from apiv2.soundverse.ai. Create your API key and manage billing at platform.soundverse.ai.
A dataset is a named collection of songs. You ingest songs into a dataset once, then search against it as often as you like. Datasets are private to your account, and all dataset endpoints are free.

Create Dataset

  • /trace/v3/dataset

Request Body

Response

Status 201 Created
Status 409 Conflict: a dataset with this name already exists in your account.

List Datasets

Returns every dataset in your account, with the layers that have been ingested into each.
  • /trace/v3/dataset
cURL

Response

Status 200 OK

Get Dataset

  • /trace/v3/dataset/{dataset_id}
cURL
Status 200 OK returns the same object as one entry of List Datasets. Status 404 Not Found when the dataset does not exist or belongs to another account:

List Dataset Tracks

This endpoint is not available on apiv2.soundverse.ai yet. Until it is, the request returns 404.
Shows every song in a dataset and which of its layers are finished, still running, or waiting. Use it to confirm a dataset is ready before searching, and to map Trace’s audio IDs back to your own file IDs.
  • /trace/v3/dataset/{dataset_id}/tracks
cURL

Response

Status 200 OK
A song is ready for a search once every layer that search needs appears in completed_tasks. If a layer is missing, ingest the song again with that depth; layers it already has are skipped.

Delete Dataset

This endpoint is not available on apiv2.soundverse.ai yet. Until it is, the request returns 404.
Deletes the dataset and everything Trace derived from it. Your uploaded source files are not deleted.
  • /trace/v3/dataset/{dataset_id}
cURL

Response

Status 200 OK
Deletion cannot be undone. Searches that name a deleted dataset will fail.