1688
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.
nexscope_1688_search_by_image/api/skill-api/v1/mcptools/callSend the user API key as a bearer token on every MCP JSON-RPC request.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxIf authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.
Use tools/call with the MCP tool name below. The arguments object should match the table on this page.
{
"jsonrpc": "2.0",
"id": "1688-search-by-image-1",
"method": "tools/call",
"params": {
"name": "nexscope_1688_search_by_image",
"arguments": {
"pageSize": 20,
"imageUrl": "https://m.media-amazon.com/images/I/61v6nYvQ7+L._AC_SL1500_.jpg",
"page": 1
}
}
}POST /api/skill-api/v1/mcphttps://www.nexscope.ai/mcp-map/1688-search-by-image| Name | Type | Required | Description |
|---|---|---|---|
imageUrl | string | optional | 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. Provide exactly one of imageUrl, imageBase64, or imageId. Example: https://m.media-amazon.com/images/I/61v6nYvQ7+L._AC_SL1500_.jpg |
imageBase64 | string | optional | 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. Provide this as the only image source. Example: {} |
imageId | string | optional | 1688 image ID. Image-search results also return this value; include it when page is greater than 1 to improve response time Example: {} |
page | integer | optional | Page number starting from 1 Example: 1 |
pageSize | integer | optional | Number of products per page; default 20, maximum 50 Example: 20 |
priceStart | string | optional | Minimum price in CNY, for example 10 Example: {} |
priceEnd | string | optional | Maximum price in CNY, for example 100 Example: {} |
filter | string | optional | Comma-separated filter conditions. Use the supported filter values documented for this endpoint Example: {} |
sort | string | optional | Sort condition as JSON in the form {field: direction}. Fields: price, rePurchaseRate, or monthSold. Directions: asc or desc Example: {} |
keyword | string | optional | Keyword used to search within the results Example: phone case |
productCollectionId | string | optional | Single product-collection ID. Use a supported collection ID documented for this endpoint Example: example-id |
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
data | any | required | Data value used by this API operation. |
code | integer | required | 0 means accepted or successful; nonzero is a platform error. |
msg | string | null | required | Msg value used by this API operation. |
ts | string | required | Epoch milliseconds. |
time | string | required | Server local time: yyyy-MM-dd HH:mm:ss. |
cost | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
traceId | string | null | required | Trace id value used by this API operation. |
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.imageId | string | optional | Uploaded image ID; send it with paginated requests to improve response time Example: example-id |
data.total | integer | optional | Number of products on this page Example: 1 |
data.totalPage | integer | optional | Total number of pages Example: 1 |
data.sourceType | string |
{
"pageSize": 20,
"imageUrl": "https://m.media-amazon.com/images/I/61v6nYvQ7+L._AC_SL1500_.jpg",
"page": 1
}{
"data": {
"imageId": "example-id",
"total": 1,
"totalPage": 1,
"columns": [],
"costToken": 1,
"products": [
{
"offerId": "example-id",
"asin": "example-id",
"imageUrl": "https://example.com/image.jpg",
"price": 1,
"consignPrice": 1,
"salesQuantity": 1,
"estimatedSalesAmount": 1,
"asinUrl": "https://detail.1688.com/offer/1040473674152.html",
"quantityBegin": 1
}
]
},
"code": 0,
"msg": null,
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}Source type; fixed value "1688" Example: null |
data.type | string | optional | Rendering style; fixed value "productWorkbenches" Example: null |
data.columns | array | optional | Column definitions used for rendering Example: [] |
data.costToken | integer | optional | Tokens consumed Example: 1 |
data.products | array | optional | Product list; see the product fields below Example: [] |
data.products[] | object | required | Item in data products. |
data.products[].offerId | string | optional | Product ID Example: example-id |
data.products[].asin | string | optional | Product identifier, same as offerId Example: example-id |
data.products[].imageUrl | string | optional | Product image URL Example: https://example.com/image.jpg |
data.products[].title | string | optional | Product title Example: null |
data.products[].price | number | optional | Wholesale price in CNY Example: 1 |
data.products[].consignPrice | number | optional | Single-item dropshipping price in CNY Example: 1 |
data.products[].salesQuantity | integer | optional | Monthly units sold Example: 1 |
data.products[].estimatedSalesAmount | number | optional | Estimated sales revenue Example: 1 |
data.products[].asinUrl | string | optional | Product URL Example: https://detail.1688.com/offer/1040473674152.html |
data.products[].isOnePsale | string | optional | Whether single-item dropshipping is available Example: null |
data.products[].isJxhy | string | optional | Whether the product is a selected supply source Example: null |
data.products[].sellerIdentities | string | optional | Seller identities, such as Super Factory, Verified Supplier, or TrustPass member Example: null |
data.products[].offerIdentities | string | optional | Product badge, such as Strict Selection Example: null |
data.products[].repurchaseRate | string | optional | Repurchase rate Example: null |
data.products[].tradeScore | string | optional | Product transaction score Example: null |
data.products[].compositeServiceScore | string | optional | Composite service-experience score Example: null |
data.products[].sendGoodsAddressText | string | optional | Dispatch location Example: null |
data.products[].deliveryTime | string | optional | Dispatch time, such as 24 or 48 hours Example: null |
data.products[].quantityBegin | integer | optional | Minimum order quantity Example: 1 |
data.products[].hasPromotion | string | optional | Whether a promotion is active Example: null |
data.products[].promotionType | string | optional | Promotion type Example: null |
data.products[].isPatentProduct | string | optional | Whether the product is patented Example: null |
data.products[].isSelect | string | optional | Cross-border Select collection indicator Example: null |
data.products[].currency | string | optional | Currency; fixed value "¥" Example: null |
data.products[].sourceType | string | optional | Source type; fixed value "1688" Example: null |
data.products[].sourceTool | string | optional | Source tool; fixed value identifying 1688 image search Example: null |
data.products[].dataType | string | optional | Data type; fixed value "monthlyData" Example: null |
data.title | string | optional | Provider-specific response title. Example: null |
data.sourceTool | string | optional | Provider-specific source tool name. Example: null |
data.costTime | integer | optional | Execution time reported by the upstream provider. Example: null |
data.page | integer | optional | Current page returned by the upstream provider. Example: null |
data.pageSize | integer | optional | Page size returned by the upstream provider. Example: null |
data.pageItemCount | integer | optional | Item count on the current page returned by the upstream provider. Example: null |
data.dataSnapshotMonth | string | optional | Data snapshot month returned by the upstream provider. Example: null |
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |