Skip to main content

Search by video

Spend less time searching and more creating by using the video itself to find relevant music.

The Search by video feature analyzes video frames and provides a list of recommended tracks perfectly suited to the video's visual scenes.

In the example below, users can click to "Get music recommendations based on the current frame". When the user clicks the button, you send an image from the user's video to Epidemic Sound. Based on the content of the frame, we'll give a list of recommended tracks in return.

Implementation steps​

  1. Upload an image and receive the corresponding imageId
  2. Get recommendations based on imageId

Upload image​

The first step is to post an image from the user's video to the image upload endpoint. The response returns an imageId that you will use in the next step to get the actual track recommendations.

We currently only support jpeg files, and the size limit for the file is 2MB.

Get recommendations based on imageId​

Use the imageId from the previous step to get track recommendations by using the matching image endpoint. This will give you a list of tracks to show to your user.

Delete frames​

If you wish to implement the Search by video feature, we have a strict requirement that you offer the capability for users to delete their uploaded content. We recommend that you place this functionality in the settings of your app.

A. Delete all frames that a user uploaded​

Users who can upload their content to get recommendations should also be able to easily delete all frames that they have previously uploaded.

Use the delete user images endpoint to delete all images for the specified user.

B. Delete specific frames​

We also offer the functionality to delete a specific image. Use the delete image endpoint with the imageId as a reference.

Partner requirements​

We're very excited to partner with you to offer a better soundtracking experience for your users. However, since some of the uploaded images can potentially be considered personal data we want to make sure that we respect the users' privacy.

If you wish to implement Search by video, we have the following requirements towards you as a partner:

  • Update your privacy policy to reflect that you are sharing the user's personal data with us.
  • Allow users to delete their uploaded content. Please see the guide to Delete all frames that a user uploaded above.