Produktbildsuche-API

POST /v1/products/search-by-image - ähnliche Produkte per Bild auf 1688 und Taobao finden.

Übergeben Sie image_id aus Bild hochladen oder liefern Sie image_base64 / image_url, um Upload + Suche in einem Aufruf auszuführen.

Request-Body

FeldErforderlichBeschreibung
channelJa1688 | taobao
image_idEins vonAus upload-image
image_base64 / image_urlEins vonUpload + Suche in einem Schritt
image_address1688Vorhandene alicdn/1688-Bild-URL
regionNeinCrop-Box, z. B. 266,799,48,581
keywordNeinInnerhalb der Bildergebnisse verfeinern
page / page_sizeNeinPaginierung
languageNeinStandard en

Beispiel

POST /v1/products/search-by-image
{
  "channel": "taobao",
  "image_id": "img_1234567890",
  "page": 1,
  "page_size": 20,
  "language": "en"
}

Antwort

Wie Keyword-Suche - StandardProductList, plus optionales pic_region_info (erkannte Motivregion).

Empfohlener Ablauf {#image-search-flow}

Option A - zwei Schritte (image_id wiederverwenden):

POST /v1/products/upload-image      → image_id returned
POST /v1/products/search-by-image → items[], total, page, ...

Option B - ein Schritt:

POST /v1/products/search-by-image
{ "channel": "1688", "image_base64": "..." }