API поиска товаров по изображению
POST /v1/products/search-by-image — находит похожие товары по изображению на 1688 и Taobao.
Передайте image_id из загрузки изображения или отправьте image_base64 / image_url для upload + search одним вызовом.
Request body
| Поле | Обязательно | Описание |
|---|---|---|
channel | Да | 1688 | taobao |
image_id | Одно из | Из upload-image |
image_base64 / image_url | Одно из | Upload + search за один шаг |
image_address | 1688 | Существующий alicdn/1688 image URL |
region | Нет | Crop box, например 266,799,48,581 |
keyword | Нет | Уточнить внутри image results |
page / page_size | Нет | Pagination |
language | Нет | По умолчанию en |
Пример
POST /v1/products/search-by-image
{
"channel": "taobao",
"image_id": "img_1234567890",
"page": 1,
"page_size": 20,
"language": "en"
}Ответ
То же, что и поиск по ключевым словам — StandardProductList, плюс опциональный pic_region_info (обнаруженная область объекта).
Рекомендуемый поток {#image-search-flow}
Вариант A — два шага (повторное использование image_id):
POST /v1/products/upload-image → image_id returned
POST /v1/products/search-by-image → items[], total, page, ...Вариант B — один шаг:
POST /v1/products/search-by-image
{ "channel": "1688", "image_base64": "..." }