用途:在1688平台按图搜索外观相似的供应商商品,用于跨境卖家的选品与货源查找。输入图片后返回商品标题、价格、起订量、月销量、复购率、交易分数、卖家身份标识等数据。
主要能力:支持图片URL、纯Base64图片或1688图片ID三种输入(三者须提供其一)。可设置页码、每页数量(1-50)、价格区间、关键词,并使用预设筛选(如1688精选、认证工厂、体验分等级、退款率、发货时效、一件代发、新品等)与排序(价格、月销量、复购率,方向asc/desc)。每页默认20条,默认按月销量降序。
使用方式:调用接口 POST /alibaba1688/imageSearch,或运行脚本 python scripts/alibaba1688_image_search.py '<JSON参数>'。脚本默认将完整JSON响应打印到stdout,可用jq或ConvertFrom-Json提取字段。分页时建议传入首页结果中的imageId以加速查询。需设置环境变量 NEXSCOPE_API_KEY。
适用场景:按图选品、同款查找、跨境货源搜索、从Amazon图片反向到1688找货、按筛选或排序精查相似商品、翻页浏览。
限制:仅支持png、jpg、jpeg格式,webp、gif等会被拒绝;Base64须为纯编码内容,不含 data:image/jpeg;base64, 前缀;page大于1时优先使用imageId。结果为实时搜索,不存入数据库,无法做二次SQL或数据分析。若请求的筛选或排序不在支持列表内,不应尝试其他变通,应告知用户可用选项。不适用于1688关键词搜索、排行榜、图片生成或编辑、评价分析、价格历史分析;Amazon图片搜索应使用 ecommerce.amazon-search-by-image。价格以CNY显示。