How to monitor online broadcasts

How to start

With Emysound you can now monitor radio broadcasts streamed over HTTP and other streaming sources. This can be especially handy if you are looking to detect copyright infringement or get advanced insights on how your data is used on a specific radio or TV stream.

To start, you need to upload tracks to the Emysound platform. You can do it with API commands or via the dashboard interface.

Backoffice screen that shows how to insert track in Emysound Cloud.

Figure 1. Insert tracks via Emysound dashboard interface.

Notice how you can insert either by uploading the file directly or specifying a source URL which will be used to get the fingerprints for the media content. You can also anotate the track with properties stored as key-value pairs. These properties later can be used for fine-tuning search queries.

Once tracks are inserted, register the streams you want to monitor.

Backoffice screen that shows how to add a stream for monitoring in Emysound Cloud.

Figure 2. Define streams to monitor.

Notice how you can enable save audio for matches playback. This will store matched audio (with additional +5 seconds at the start/end) for 90 days. The audio can be listened on query match page, or downloaded via media API endpoint.

curl --request GET \
     --url 'https://developers.emysound.com/api/v1.1/media/query-match-id?applicationId=your-application-id&jsonApiKey=your-json-api-key' \
     --header 'Accept: application/json'

Once tracks are inserted and streams are registered, Emy will continuously monitor these broadcasts. You can then download match information and get advanced analytics and insights on matches page.

Starting from API v1.1, you can facets the results for matches, identifying metrics like: most popular tracks, top hits per stream, most popular artists and more.

Using API to register streams for monitoring

You can achieve the same functionality as above by using directly JSON API.

Log in to Emysound dashboard. Navigate to API Keys screen and copy the Application ID and JSON API Key. Use the application ID as username and JSON API Key as password when accessing the API via HTTP protocol.

Figure 3. Find your API keys in the dashboard.

Below is an example of a cUrl command that saves a track in Emy.

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

Once tracks are inserted just register the stream for continuous monitoring.

curl --request POST \
  --url https://developers.emysound.com/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
}

If you are looking to monitor streams from a particular country or region you can use My Tuner to search for the stations.

Registered matches can later be exported to JSON via the matches API.

curl --request GET \
  --url 'https://developers.emysound.com/api/v1.1/matches?limit=50&sinceDays=90' \
  --header 'Authorization: Basic Admin:' \
  --header 'Accept: application/json'

Provided reports will give you detailed information about when a match occurred, how many times, and on which particular station.

The ability to forward JSON notification requests to configurable endpoints will be added to Emysound in a short timeframe. Receiving real-time webhook requests will give you an option to take action immediately as the match occurs.