1688 Sourcing

1688 Search By Image

Perform image-based product search on the 1688 platform. Use an image URL to find visually similar supplier products, returning title, price, minimum order quantity, monthly sales, repurchase rate, trade score, and seller identity. Triggered when users mention 1688 image search, 1688 visual search, find supplier by image, reverse image search 1688, 1688 product sourcing by image, or Alibaba 1688 image search. Even if the user does not explicitly mention "image search," this skill should be triggered whenever a user provides an image URL and wants to find matching or similar products on the 1688 wholesale platform.

post/api/skill-api/v1/skills/1688-search-by-image/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/1688-search-by-image/run
  • Auth: HTTP bearer

Headers

X-Nexscope-Http-Status'legacy' | 'semantic'

Use semantic for HTTP error statuses on run and task-result requests. Without this header v1 retains legacy status behavior. The JSON envelope is unchanged; code 0 means success or acceptance, not asynchronous completion.

Request body

imageUrlstring

Public HTTP/80 or HTTPS/443 URL, maximum 1,000 characters, without redirects. A sole direct source is checked for PNG/JPEG headers, at most 14.3 MiB, each dimension at most 20,000 and at most 40,000,000 pixels. This is not full pixel-integrity validation. imageId or ambiguous multiple sources preserve provider behavior and skip new preflight. Provide at least one image source.

imageBase64string

Raw standard Base64 for PNG/JPEG; optional padding and outer whitespace allowed, embedded whitespace and data URI prefixes rejected for a sole direct source. Byte/header limits match imageUrl; at most 19,992,848 Base64 characters after outer whitespace trimming. Multiple-source inputs retain existing provider behavior.

imageIdstring

1688 image ID. Image-search results also return this value; include it when page is greater than 1 to improve response time

pageinteger

Page number starting from 1

pageSizeinteger

Number of products per page, maximum 50

priceStartstring

Minimum price in CNY, for example 10

priceEndstring

Maximum price in CNY, for example 100

filterstring

Comma-separated filter conditions. Use the supported filter values documented for this endpoint

sortstring

Sort condition as JSON in the form {field: direction}. Fields: price, rePurchaseRate, or monthSold. Directions: asc or desc

keywordstring

Keyword used to search within the results

productCollectionIdstring

Single product-collection ID. Use a supported collection ID documented for this endpoint

Example request

{
  "imageUrl": "https://m.media-amazon.com/images/I/61v6nYvQ7+L._AC_SL1500_.jpg",
  "page": 1,
  "pageSize": 10,
  "keyword": "phone case",
  "productCollectionId": "example-id"
}

Response

Successful response.

codeinteger required

0 means accepted or successful; nonzero is a platform error.

msgstring nullable required
tsstring required

Epoch milliseconds.

timestring required

Server local time: yyyy-MM-dd HH:mm:ss.

coststring required

Elapsed milliseconds, never credits; -1 outside web requests.

traceIdstring nullable required

Example response

{
  "data": {
    "imageId": "example-id",
    "total": 1,
    "totalPage": 1,
    "costToken": 1,
    "products": []
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.