商品画像検索 API
POST /v1/products/search-by-image — 1688 と Taobao で画像から類似商品を検索します。
upload image から取得した image_id を渡すか、image_base64 / image_url を指定してアップロード + 検索を1回の呼び出しで行います。
リクエスト本文
| フィールド | 必須 | 説明 |
|---|---|---|
channel | はい | 1688 | taobao |
image_id | いずれか1つ | upload-image から取得 |
image_base64 / image_url | いずれか1つ | 1ステップでアップロード + 検索 |
image_address | 1688 | 既存の alicdn/1688 画像 URL |
region | いいえ | クロップ範囲。例: 266,799,48,581 |
keyword | いいえ | 画像検索結果内で絞り込み |
page / page_size | いいえ | ページネーション |
language | いいえ | デフォルト en |
例
POST /v1/products/search-by-image
{
"channel": "taobao",
"image_id": "img_1234567890",
"page": 1,
"page_size": 20,
"language": "en"
}レスポンス
keyword search と同じ StandardProductList に、任意の pic_region_info (検出された対象領域) が加わります。
推奨フロー {#image-search-flow}
Option A — 2ステップ (image_id を再利用):
POST /v1/products/upload-image → image_id returned
POST /v1/products/search-by-image → items[], total, page, ...Option B — 1ステップ:
POST /v1/products/search-by-image
{ "channel": "1688", "image_base64": "..." }