1688 Image-Based Product Search

This skill performs visual product searches on the 1688 platform using an image URL, helping cross-border sellers find visually similar supplier products for sourcing.

Core Concepts

1688 Image Search uses visual recognition to find products with similar appearance on the 1688 wholesale marketplace. It returns supplier product data including title, price, minimum order quantity, monthly sales, repurchase rate, trade score, and seller identity badges.

Data Fields

Parameter Guide

Image Rules:

1. Only png, jpg, jpeg formats are supported. webp, gif, and other formats are NOT supported.
2. Base64 string must be pure encoded content WITHOUT the data:image/jpeg;base64, prefix.
3. Image source — one of imageUrl, imageBase64, or imageId must be provided (at least one required).

Supported Filters

Multiple filters can be combined with commas (e.g. 1688Selection,totalEpScoreLv1,qrr0).

Supported Sort Fields

Sort format example: {"price":"asc"} for price low to high.

Supported Product Collection IDs

Usage

• API Endpoint: POST /alibaba1688/imageSearch (see references/api.md for full parameters, responses, and error codes)
• Python Script: python scripts/alibaba1688imagesearch.py '<JSON parameters>'

Output strategy (script default behavior):

• Prints the full JSON response to stdout

Data reading tip: Use jq or ConvertFrom-Json to extract specific fields from the response as needed.

Usage Examples

1. Basic image search

Search 1688 for products visually similar to this image: https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg

2. Search with filters

Search 1688 for products similar to this image: https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg -- filter by 1688 Premium Selection, sort by price descending, page 1

3. Search with sorting

Search 1688 for products similar to this image: https://example.com/product.jpg -- sort by price from high to low

4. Paginated search

Search 1688 for products similar to this image: https://example.com/product.jpg -- page 2, 50 results per page

5. Price range filter

Search 1688 for products similar to this image: https://example.com/product.jpg -- price range 10-100 CNY

Display Rules

1. Present data clearly: Show results in a structured table with key columns: product image, title, price, dropship price, monthly sales, minimum order quantity, repurchase rate, and seller identity
2. Image display: When the response includes imageUrl for products, display them inline for visual comparison
3. Price display: Always show price in CNY format
4. Seller badges: Display seller identity badges (Super Factory / Verified Supplier / TrustPass member) and product badges (Premium Selection) prominently
5. Result count: Always inform the user of total results and current page/total pages
6. Pagination hint: When more pages are available, suggest the user can request the next page
7. Filter/sort limitation: If the user requests a sort or filter not in the supported list, do NOT attempt any workaround. Inform the user of the supported options
8. No secondary processing: Results are real-time and not stored in a database, so secondary SQL/data processing is not available

Important Limitations

1. Data real-time nature: Results are live searches, not stored in any database.
2. Logic constraint: If the user requests sort or filter conditions not in the preset supported list, do NOT call any other tool or logic to compensate.
3. Image input: One of imageUrl, imageBase64, or imageId is required. For page > 1, prefer passing imageId from the first page result to speed up queries.
4. Image format: Only png, jpg, jpeg are supported. webp, gif, and other formats will be rejected.
5. Base64 format: The imageBase64 value must be the raw Base64 string only — do NOT include the data:image/jpeg;base64, prefix.
6. Page size: Maximum 50 results per page.

User Expression & Scenario Quick Reference

Applicable -- Visual product sourcing scenarios on 1688:

Not applicable -- Needs beyond 1688 image search:

• Text/keyword-based 1688 search
• 1688 product rankings/trending
• Amazon image search (use ecommerce-amazon-search-by-image)
• Image generation or editing
• Product review analysis
• Price history or trend analysis

Boundary judgment: When users say "find supplier" or "find same style," if they provide an image URL and the intent is to find visually similar products on 1688, this skill applies. If they want keyword-based search or ranking data on 1688, use other tools instead.

Authentication

Set NEXSCOPEAPIKEY. Visit https://www.nexscope.ai/help/skills-external-access?co-from=skillNS to manage credits.