Insert tracks

Insert audio or video with a multipart request. The mediaType field controls whether Emy fingerprints the audio track, the video frames, or both. Attach any key-value metaFields you want returned with future matches.

curl 'https://<your-emysound-host>/api/v1.1/tracks' \
    -H 'Authorization: Basic Admin:' \
    -F 'id=test-id' \
    -F 'title=test-title' \
    -F 'artist=test-artist' \
    -F 'metaFields[test-meta-key]=test-meta-value' \
    -F 'mediaType=Audio,Video' \
    -F 'file=@ad.mp4'

The same insert with the SoundFingerprinting.Emy .NET client:

// connect to Emy on port 3399
var emyModelService = EmyModelService.NewInstance("localhost", 3399);
    
// define track info
var track = new TrackInfo("GBBKS1200164", "Skyfall", "Adele", 290d);
 
// create fingerprints
var hashedFingerprints = await FingerprintCommandBuilder.Instance
                                 .BuildFingerprintCommand()
                                 .From(pathToAudioFile)
                                 .UsingServices(audioService)
                                 .Hash();
 								
// store hashes in the database for later retrieval
emyModelService.Insert(track, hashedFingerprints);

You can also ingest directly from a URL — Emy downloads and fingerprints the media for you:

 curl --request PUT \
  --url 'http://localhost:3340/api/v1.1/tracks?encodedMediaUrl=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DvNkIj_BhHvY' \
  --header 'Accept: application/json' \
  --header 'Authorization: Basic Admin:' \
  --header 'Content-Type: application/*+json' \
  --data '{"id":"e96d43b7-0f02-486c-a6d5-acc6bbfdd7be","title":"Bach Air on G string Piano","artist":"Valentina Lisitsa","mediaType":"Audio"}'

Monitor live streams

Register an HTTP or HLS stream and Emy monitors it continuously, matching everything it hears against your catalog. Set savePlaybackTrack to keep the aired audio available for playback and review.

curl --request POST \
  --url https://<your-emysound-host>/api/v1.1/streams \
  --header 'Authorization: Basic Admin:' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/*+json' \
  --data '
{
  "streamId": "CNN",
  "streamUrl": "https://tunein.streamguys1.com/cnn-new",
  "savePlaybackTrack": true
}

Don't have a stream URL at hand? The backoffice ships with a built-in radio directory — thousands of stations, searchable by country and genre — so you can pick a station and start monitoring without leaving the dashboard.

Read more in the step-by-step guide: How to monitor online broadcasts.

Under the hood

Emy is not a wrapper around a general-purpose database — the index is purpose-built for fingerprint lookups:

• In-memory min-hash index over spectral fingerprints. Lookups touch packed, block-compressed postings at roughly 21 bits per entry, so catalogs of hundreds of thousands of tracks fit in commodity RAM.
• Lock-free reads, background sealing. Inserts land in append-only delta buckets that readers traverse without locks; generations are compacted in the background. Queries never wait for writes.
• Audio and video in one index. Both fingerprint types live in the same storage and can be matched in a single query — no second system to operate.
• Exact coverage reconstruction. Matches report where content aligns in the query and in the track, including gaps — not just a similarity score.
• Replication for high-availability deployments (Enterprise), with leaders handling inserts and followers serving queries.