You get a Keyword! And you get a Keyword!

Originally published on the Clarify.io blog. View archived copy.

Our audio and video search requires you to know something about your media. After all, it’s hard to find something if you don’t know what to look for… until now.

With our new Keywords Insight, our API performs its normal tuned automatic speech recognition to learn about your audio and video. From those results, it calculates the relevant keywords and allows you to retrieve them with just a couple requests.

To date, this is the most important insight we’ve released in that it informs you about your media. In fact, we already have developers using the results of the Keywords Insight to gain information about the media and perform an informed search.

Using the Keywords Insight is easy.

Just as you always would, add your media to the system:

and you’ll receive 201 Created response code along with a payload like this:

The most important part of this payload is the href of the clarify:insights key. Once processing is complete, you can make a request to that URL as shown:

The response is the list of insights available for that bundle:

In this case, we’ll just worry about the insight:spoken_keywords URI. We make a GET request to that URI just as any other:

The result is the full keyword list:

From here, we can process the keywords just like any other JSON array. You may want to use them to perform informed searches, display word clouds, or tag your media. At this point, it’s up to you.