摘要：
1688.item_search_img（1688 拍立淘图片检索接口）广泛用于 B2B 货源溯源、跨境选品、工厂比价、样品找货。本文整理完整返回字段，包含顶层响应、分页统计、商品主体、供应商 B 端专属字段，附带真实 JSON 示例、业务用途、开发踩坑，适合 CSDN、阿里云、腾讯云论坛发布，用于供应链系统、ERP、选品工具开发参考。
一、接口基础简介
- 接口标识：
1688.item_search_img，别名拍立淘图片搜商品 - 入参：公网图片 URL / Base64 图片编码
- 输出：同款、相似款 1688 批发货源结构化数据
- 核心特点：相比 C 端淘宝拍立淘，额外返回起订量、阶梯价、工厂标识、一件代发、产地、30 天批发销量等 B2B 批发专属字段。
- 鉴权：MD5 签名，存在 QPS 限流与调用额度限制。
二、顶层公共响应字段
顶层用于判断请求状态，排查异常、日志定位。
表格
| 字段 | 类型 | 说明 | 业务用途 |
|---|---|---|---|
| code | String | 状态码，0 代表请求成功 | 判断接口调用是否正常 |
| msg | String | 响应描述文本 | 排查签名错误、限流、图片异常、权限不足 |
| request_id | String | 本次请求唯一 ID | 线上问题排查、日志溯源 |
| data | Object | 业务数据主体对象 | 解析货源数据的根对象 |
三、data 分页统计字段
控制分页遍历批量货源检索场景。
表格
| 字段 | 说明 |
|---|---|
| total_results | 本次图片检索匹配到商品总条数 |
| real_total_results | 过滤下架、违规商品之后真实有效结果数 |
| page | 当前页码 |
| page_size | 每页返回商品条数，默认 20，最大 50 |
| pagecount | 总页数 |
四、item [] 商品数组核心字段（业务重点）
item数组为检索结果列表，每一条对应一款货源，B2B 批发业务全部依赖该层字段。
表格
| 字段 | 类型 | 说明 & 业务场景 |
|---|---|---|
| similarity | Float | 核心字段，视觉相似度 0‑1；≥0.75 判定精准同款；0.6‑0.75 相似变体；小于 0.6 建议过滤，过滤非同款噪声数据 |
| num_iid / productId | String | 1688 商品 offerId，商品全局唯一 ID；可传给商品详情接口获取 SKU、库存、详情信息 |
| title | String | 商品批发标题；用于类目复核、关键词过滤 |
| pic_url | String | 商品主图地址；用于前端渲染、二次图像比对 |
| price | String | 商品挂牌批发价；多 SKU 场景一般为区间下限 |
| price_range | Object | 多规格阶梯价格对象，包含 min_price、max_price；核算批量拿货成本 |
| minOrderQuantity / moq | Int | 最小起订量 MOQ，B 端核心字段；筛选满足采购门槛货源 |
| sales30d / sales | Int | 近 30 天批发成交销量；判断款式热度、工厂出货能力 |
| unit | String | 计价单位：件、套、kg 等 |
| is_factory | Boolean | 是否源头工厂；true = 工厂，false = 贸易商；筛选一手货源 |
| one_psale | Boolean | 是否支持一件代发；跨境代发业务筛选使用 |
| is_jxhy | Boolean | 是否精选 1688 优质货源标识 |
| sellerName | String | 供应商 / 店铺名称；货源溯源、供应商统计 |
| sellerId | String | 供应商店铺 ID；可对接商家相关接口 |
| sellerArea / location | String | 发货产地；产业带筛选、评估物流成本 |
| detail_url / detailPageUrl | String | 1688PC 商品详情链接；人工复核、二次采集入口 |
