Finds images in your asset library based on visual similarity or content
Returns a list of resources that are visually similar to a specified image. You can provide the source image for comparison in one of three ways:
- Provide a URL of an image
- Specify the asset ID of an existing image
- Provide a textual description
Basic authentication using Cloudinary API Key and API Secret.
In: header
Path Parameters
The cloud name of your product environment.
Request Body
application/json
The visual search parameters.
Parameters for visual search operations
Parameters for visual search operations
The URL of an image to use as the source for finding visually similar images
uriThe minimum similarity score (between 0 and 1.0) that a resource must have to be included in the response
0 <= value <= 1Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/v1_1/my_cloud/resources/visual_search" \ -H "Content-Type: application/json" \ -d '{ "image_url": "http://example.com" }'{ "total_count": 0, "time": 0, "resources": [ { "asset_id": "string", "public_id": "string", "asset_folder": "string", "filename": "string", "display_name": "string", "format": "string", "version": 0, "resource_type": "image", "type": "upload", "created_at": "2019-08-24T14:15:22Z", "uploaded_at": "2019-08-24T14:15:22Z", "bytes": 0, "backup_bytes": 0, "width": 0, "height": 0, "aspect_ratio": 0, "pixels": 0, "url": "http://example.com", "secure_url": "http://example.com", "status": "active", "access_mode": "public", "access_control": [ { "access_type": "token", "key": "string", "start": "string", "end": "string" } ], "etag": "string", "created_by": { "access_key": "string" }, "uploaded_by": { "access_key": "string" }, "context": { "property1": "string", "property2": "string" }, "tags": [ "string" ], "image_metadata": {}, "image_analysis": {}, "metadata": {}, "quality_analysis": {}, "accessibility_analysis": {} } ], "next_cursor": "string", "aggregations": { "values": [ { "value": "string", "count": 0 } ], "ranges": [ { "from": 0, "to": 0, "count": 0 } ] }}Provides a powerful query interface to filter and retrieve assets and their details POST
Returns a list of resources matching the specified search criteria. Uses a Lucene-like query language to filter assets by descriptive attributes (`public_id`, `asset_id`, `filename`, `display_name`, `folder` / `asset_folder`, `tags`, `context.<key>`), file details (`resource_type`, `type`, `format`, `bytes`, `width`, `height`, `duration`, `pages`, `aspect_ratio`, `transparent`, `grayscale`), lifecycle dates (`uploaded_at`, `created_at`, `taken_at`, `updated_at`, `last_updated.<kind>`), moderation and lifecycle state (`status`, `moderation_status`, `moderation_kind`), embedded data (`image_metadata.*`), structured metadata (`metadata.<external_id>`), and analysis fields (`face_count`, `colors`, `quality_score`, `illustration_score`, `accessibility_analysis.*`). Supports sorting, aggregate counts, and complex boolean expressions. Examples: `tags:shirt AND uploaded_at>1d`, `resource_type:image AND bytes>1000000`, `folder:products OR context.category:electronics`. See the [search expressions guide](https://cloudinary.com/documentation/search_expressions.md) for the full syntax and field reference.
List initial backups GET
Lists initial backup operations for the active product environment, ordered from most recent to oldest.