Search Flows

There are many ways to use SonicSearch. All of them use /api/sonicsearch/search, but each follows a different sequence to get there.

Upload A Track

Upload a track
Process the track
Retrieve matches (using the search_id parameter for /api/sonicsearch/search)

Search Using An Existing Track or Existing Search

Find an existing track’s SourceAudio ID or use an existing search_id
Retrieve matches (using the track_search or search_id parameters for /api/sonicsearch/search)

You can initiate searches using media from Youtube or SoundCloud. Your request will return immediately once the URL is verified. You’ll be able to track the progress using an API call explained in the next section. The request will return an id that you will use to track its progress, as well as the media title, for user feedback.

Choose a YouTube or Soundcloud URL
Process the URL
Check URL Progress to obtain search_id
Retrieve matches (using /api/sonicsearch/search)

Search / Retrieving Matches

/api/sonicsearch/search

Param	Required	Description
search_id	yes	The search_id from processFile or other previous search
track_search	yes	The SourceAudio track ID you want to find matches against

Example Response

{
	"search_type": "search",
	"search_id": 512,
	"matches": [
		{
			"track_id": 2469585,
			"score": 0,
			"filename": "PattyCake Version_30.mp3",
			"external_id": "455"
		},
		{
			"track_id": 2469587,
			"score": 152.318,
			"filename": "BakersDozen_30.mp3",
			"external_id": "8666"
		},
		{
			"track_id": 2469586,
			"score": 162.7507,
			"filename": "ChooChoo.mp3",
			"external_id": "234"
		},
		//...
	],
	"match_count": 50
}

SourceAudio

SonicSearch Search