Product Updates

Search-api-blog

Finding the right media assets with a powerful new search API

Jul 19, 2017

Our new search API allows you to incorporate advanced search capabilities into your media management workflow and find images and videos according to any criteria, such as tags, folders, size, resolution, aspect ratio, and more.

For example:

Copy to clipboard
Cloudinary::Search.expression('tag:dog uploaded_at>1m aspect_ratio>="4:3" width>2048').execute

This query returns a JSON response that provides a summary of the search results and lists all matching images. In this example, the response includes all images tagged with 'dog', with an aspect ratio of 4:3, wider than 2048px, and that were uploaded within the past month. Results are sorted by relevance.

Search API Result - Dog

Read more about our Search API capabilities in this blog post and in our docs.

The asset search API is part of our Admin API and is available in the following SDKs: Ruby, Node, Java, PHP, Python and Scala.

Included for our Advanced Extra plans and higher and requires a small setup on our side. An additional search tier is available which allows more advanced functionality, such as embedded image metadata, image analysis and aggregations.

← Back to all product updates