Product image search API
POST /v1/products/search-by-image — find similar products by image on 1688 and Taobao.
Pass image_id from upload image, or supply image_base64 / image_url for upload + search in one call.
Request body
| Field | Required | Description |
|---|---|---|
channel | Yes | 1688 | taobao |
image_id | One of | From upload-image |
image_base64 / image_url | One of | Upload + search in one step |
image_address | 1688 | Existing alicdn/1688 image URL |
region | No | Crop box, e.g. 266,799,48,581 |
keyword | No | Refine within image results |
page / page_size | No | Pagination |
language | No | Default en |
Example
POST /v1/products/search-by-image
{
"channel": "taobao",
"image_id": "img_1234567890",
"page": 1,
"page_size": 20,
"language": "en"
}Response
Same as keyword search — StandardProductList, plus optional pic_region_info (detected subject region).
Recommended flow {#image-search-flow}
Option A — two steps (reuse image_id):
POST /v1/products/upload-image → image_id returned
POST /v1/products/search-by-image → items[], total, page, ...Option B — one step:
POST /v1/products/search-by-image
{ "channel": "1688", "image_base64": "..." }