{"id":21558,"date":"2017-07-19T16:04:48","date_gmt":"2017-07-19T16:04:48","guid":{"rendered":"http:\/\/finding_the_right_media_assets_with_a_powerful_new_search_api"},"modified":"2024-06-05T17:07:29","modified_gmt":"2024-06-06T00:07:29","slug":"finding_the_right_media_assets_with_a_powerful_new_search_api","status":"publish","type":"post","link":"https:\/\/cloudinary.com\/blog\/finding_the_right_media_assets_with_a_powerful_new_search_api","title":{"rendered":"Finding the right media assets with a powerful new search API"},"content":{"rendered":"

Great content is hard to come by. You can invest a lot of time and effort in building a great media library, but if content managers and editors can\u2019t quickly find what they need at the right time, it\u2019s almost useless (and frustrating). Good search capabilities allow you to provide them with a better experience: present relevant content or a well-organized catalog by a variety of criteria such as tags, folders, size, resolution, aspect ratio, faces, colors and many more.<\/p>\n

Introducing image & video advanced search API<\/h2>\n

Cloudinary is an end-to-end image and video management solution<\/a>. Our new search API allows you to incorporate advanced search capabilities into your media management workflow<\/strong>, letting your content managers easily find assets uploaded to Cloudinary by almost any criteria. You can use the data in the search response to display an organized view of your catalog, display relevant content, or even expose dynamic search options directly.<\/p>\n

For example, let\u2019s say John is an editor who is writing an article that needs an image. The website design requires a landscape image with good quality. John also remembers that the company purchased some images earlier this month and there was one with a dog that could be just right, that may have been tagged. Well, if the company\u2019s images are stored in a Cloudinary account, then finding that perfect image is easy with the Search API.<\/p>\n

Here\u2019s a quick Ruby example:<\/p>\n

Cloudinary::Search.expression('tag:dog uploaded_at>1m aspect_ratio>=\"4:3\" width>2048'<\/span>).execute\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n
\"Search<\/p>\n
\"Search<\/p>\n
\"Search<\/p>\n
\"Search<\/p>\n
<\/div>\n
The search API is based on a robust new asset search engine<\/strong>, so that even if you have millions of assets, results are returned immediately. You can truly focus on your core product and let us do the searching for you.<\/p>\n
Search for any combination of criteria<\/h3>\n
The search expression syntax is Lucene-based<\/a>, and supports any combination of attributes:<\/p>\n
This query returns a JSON response<\/a> that provides a summary of the search results and lists all matching images. In this example, the response includes all images tagged with \u2018dog\u2019, with an aspect ratio of 4:3, wider than 2048px, and that were uploaded within the past month. Results are sorted by relevance.<\/p>\n