1688.item_search_img（1688 拍立淘图片搜索 API）全业务场景落地手册

手册定位：面向跨境 ERP、选品系统、供应链 SaaS、无货源铺货工具开发实战文档；覆盖权限申请、参数详解、图片预处理、全业务场景、返回 JSON 样例、架构方案、踩坑排错、风险合规，可直接用于开发方案评审与技术文档输出。 接口别名：1688 拍立淘图搜 API；；对外调用 method：1688.item_search_img。

一、前置接入准备

一、接口基础能力（数据底座）1. 请求参数

1.1 图片硬性规范（决定匹配准确率，开发必须做预处理）

传参二选一： ① img id 传入公网 HTTPS 图片 URL（优先推荐，减少 Base64 编解码异常）；URL 特殊字符必须做 URL 编码。 ② imh id 传入图片 Base64；去掉data:image/jpg;base64,前缀，删除换行符，否则报参数错误。

1.2 请求基础信息

接口名称：tb.item_search_img（淘宝图片搜索API，taobaoapi2014前往体验）

请求网关： c0b.cc/R4rbK2 （HTTPS，支持 GET/POST）

接口版本：2.0

鉴权方式：AppKey + AppSecret 签名校验（MD5/HMAC-SHA256）

调用限制：存在单秒频次、每日调用配额，高频场景需做限流、缓存处理。

核心作用：根据商品 ID，获取商品标题、价格、SKU、库存、图文、类 目、销量、规格属性等全量详情数据。

• mum_iid:商品唯一 ID（核心主键，联动其他接口）
• title标题、price原价、promotion_price促销价
• pic_url主图、detail_url商品链接
• sales销量、area发货地、店seller_nick铺名、is_tmall是否天猫
• match_rate：图片相似度（0~1，≥0.9 判定为同款）
• 商品类目

1.3 业务入参详解

二、标准返回 JSON 示例

json

{
    "result": {
        "success": true,
        "total_results": 46,
        "product_list": [
            {
                "product_id": "745362891234",
                "title": "夏季纯棉短袖T恤女 宽松大码女装 一件代发",
                "price": "12.50",
                "price_range": "12.50‑15.80",
                "sales": 2360,
                "similar_score": 0.87,
                "pic_url": "https://cbu01.alicdn.com/img/xxx.jpg",
                "detail_url": "https://detail.1688.com/offer/745362891234.html",
                "min_order": 2,
                "supplier": {
                    "supplier_id": "34567891",
                    "supplier_name": "XX服饰工厂店",
                    "is_factory": true,
                    "is_one_delivery": true
                }
            },
            {
                "product_id": "745362891235",
                "title": "韩版女士休闲T恤女装基础款",
                "price": "13.20",
                "sales": 1120,
                "similar_score": 0.72,
                "min_order": 5,
                "supplier": {
                    "is_factory": false
                }
            }
        ]
    }
}

重要业务提示：图搜返回的price为摘要展示价格，不能作为真实交易价格；拿到product_id后，必须调用商品详情接口获取真实 SKU 阶梯价、库存、发货时效，否则会出现价格失真，造成业务亏损。

本地二次过滤规则（业务层必须实现）

1. similar_score相似度阈值：业务建议≥0.7；低于 0.7 直接丢弃，减少视觉近似但实物完全不同的干扰结果。
2. 过滤：min_order大于业务可接受起订量；过滤非实力商家、低销量。
3. 优先排序：相似度降序→工厂店优先→销量降序→价格升序。
4. 去重：同一个只保留一条，接口会返回重复商品。

三、七大完整业务场景落地（电商 ERP / 跨境 SaaS 直接复用）

场景 1：跨境电商选品溯源（Temu/Ozon/Coupang/ 独立站）

业务痛点：海外平台爆款图片，没有中文关键词，无法搜索国内货源；人工翻译关键词匹配效率低。

业务流程：

1. 抓取海外平台商品主图；图片预处理（裁剪、压缩、去除水印）。
2. 调用1688.item_search_img，search_type=1，传入预估类目 cat_id。
3. 本地过滤：筛选支持一件代发、可跨境发货、起订量符合铺货要求的工厂货源。
4. 使用商品详情接口拉取 SKU、重量、材质，核算跨境利润。
5. 输出候选货源清单，支持导出；低相似度结果人工复核。

典型产品：反向海淘系统、跨境选品工具、1688 采集上 Ozon/Temu 工具的识图找源模块。

场景 2：ERP 识图批量铺货（无货源店群）

业务痛点：运营拿到外网商品图，手动复制标题搜索 1688，录入参数效率极低。

业务流程：

1. ERP 前端上传图片；图片预处理。
2. API 图搜返回货源列表；运营选择合适货源。
3. 自动回填标题、图片、规格参数；调用详情接口拿 SKU。
4. 对接刊登 API，一键刊登到 Temu、Shopee、Ozon 等店铺。

风险提示：禁止完全全自动不经人工审核直接刊登；图片视觉相似不等于面料尺寸一致，容易大量售后退货；需要设置人工预审开关。

场景 3：竞品供应链监控调研

业务需求：定时抓取同行店铺上新主图，批量识图溯源上游 1688 供应商，监控竞品新款货源、批发成本。

架构要点：

1. 异步任务队列，控制 QPS，禁止同步循环。
2. Redis 缓存图片 MD5 对应的搜索结果，7‑15 天缓存，减少重复调用。
3. 匹配到同款后，定时同步商品详情接口监控价格上涨、库存清零。
4. 告警：竞品上新匹配到高潜力货源推送运营。

场景 4：企业 B 端采购、样品溯源比价

业务需求：展会样品实拍、客户发来样品图片，无货号，快速匹配多家工厂比价。

流程：图片上传→图搜→筛选工厂商家、阶梯报价、起订量；导出供应商对比报表，辅助采购决策。

场景 5：小红书 / 抖音爆款反向找货源

业务需求：短视频平台爆款商品截图，溯源 1688 源头，做国内无货源选品。

关键点：短视频截图质量差，预处理必须裁剪掉 UI 按钮水印；优先使用search_type=1

无结果切换search_type=2。

场景 6：舆情 & 仿品初筛（知识产权风控）

业务需求：输入自有品牌商品图，批量检索全网同款货源，快速发现仿款链接做初筛。

注意：API 仅做初筛，不能直接作为侵权判定依据，需要人工复核证据。

场景 7：客户报价系统识图找货（CRM / 销售报价系统）

业务需求：客户发来样品图片，销售一键识图匹配货源，快速生成报价单。 流程：客户上传图片→图搜匹配货源→自动带出批发价，结合运费、利润模板生成报价。