Retrieve by image

Retrieve AI optimized search results for products (or optionally other sections) by image

Query Params
string
required
length between 1 and 100

The key of the index to use.

string
length between 1 and 100
Defaults to Products

The section of the index to use.

json

A JSON string containing a instructions on how to map item variation data in the response (typically used for swatches). More details, including the exact schema for this value can be found here

fmt_options
object

An object containing options to format different aspect of the response.

string
length between 1 and 100

The id of the client and version that the request is coming from, such as cio-js-2.90.

us
array of strings

A customer defined context (such as vip-club-member) used to evaluate redirect or refined tag rules. Pass multiple segments by passing multiple us arguments.

us
string

A customer generated anonymized identifier for a user on a customer website. It should only be sent for logged in customers and helps Constructor to tie multiple client and session ID's together to form a behavioral data profile across devices.

integer

An integer representing the users session number (starting with 1), incremented after a 30 minute period of inactivity.

string

A globally unique identifier for the user browser (or mobile application instance) making the request.

Body Params
Responses

400

Validation Error

Language
LoadingLoading…
Response
Choose an example:
application/json