Vision API Product Search documentation

Vision API Product Search allows retailers to create products, each containing reference images that visually describe the product from a set of viewpoints. Retailers can then add these products to product sets. Currently Vision API Product Search supports the following product categories: homegoods, apparel, toys, packaged goods, and general .

When users query the product set with their own images, Vision API Product Search applies machine learning to compare the product in the user's query image with the images in the retailer's product set, and then returns a ranked list of visually and semantically similar results.

Vision API Product Search resources overview

Vision API Product Search has three resource types: product sets, products, and reference images.

  • Product Set - A container for a group of products with reference images for those products. When you query for product images, you must supply the id of the product set to search.

  • Product - Describes a product. Contains one or more reference images, a product category, and optional list of product labels that describe the product. You can add any key/value pair as a label. Label examples include color=blue, style=kids.

    Currently supported product categories are: homegoods-v2, apparel-v2, toys-v2, packagedgoods-v1, and general-v1 *.

  • Reference Image - An image file for a product. The metadata includes a product ID, a category, and bounding box details. Reference images must belong to a product.

The API contains methods for creating, listing/getting, updating, and deleting product sets, products, and reference images.

Discuss Vision API Product Search and Get Updates

Join the cloud-vision-discuss Google group to discuss Vision API Product Search and receive Vision API Product Search announcements and updates.