v48

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-043076233.0 KB
v1

Search

Search for products with pagination support.

At least one of query, image_url, base64_image, or page_token must be provided; requests with none of these will return 422.

post/v1/search

Request body

querystring nullable

Search query. At least one of query, image_url, base64_image, or page_token must be provided.

image_urlstring nullable

Image URL. At least one of query, image_url, base64_image, or page_token must be provided.

base64_imagestring nullable

Base64 encoded image. At least one of query, image_url, base64_image, or page_token must be provided.

limitinteger nullable

Optional limit on the number of results. Default is 20, max is 30.

page_tokenstring nullable

Opaque token from a previous search response to fetch the next page of results.

Response

Successful Response

next_page_tokenstring nullable

Token to fetch the next page. Null when no more results.