一、接口基础能力（数据底座）
1. 请求参数
1.1 图片硬性规范（决定匹配准确率，开发必须做预处理）
| 项目 | 规范 | 禁忌 |
|---|---|---|
| 格式 | JPG/JPEG、PNG | GIF、WebP、透明底 PNG、拼图、长截图 |
| 大小 | ≤1MB，最大不超 4MB | 原图 5MB 以上直接触发 413 超限报错 |
| 分辨率 | 最小边≥256px；推荐 720‑800px | 缩略小图、模糊截图匹配率暴跌 |
| 画面 | 商品主体居中，主体占画面＞60%；少水印、少杂物 | 大面积水印、多件混拍、背景杂乱、纯文字图 |
传参二选一： ① 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 业务入参详解
| 参数 | 类型 | 必选 | 说明 | 业务建议 |
|---|---|---|---|---|
| imgid | string | 是 | 公网图片 URL / Base64 编码图片 | 优先公网 URL |
| search_type | int | 是 | 1 = 精准同款；2 = 泛相似货源 | 选品溯源先用 1，无结果降级 2 |
| cat_id | long | 否（强烈建议传） | 1688 类目 ID | 锁定类目，避免跨类目乱匹配，显著降低噪声 |
| page | int | 否 | 页码，默认 1 | 超过 20 页基本无有效数据 |
| page_size | int | 否 | 每页返回条数 | 最大 50，业务取 20 足够 |
| sort_type | int | 否 | 排序 | 0 默认；1 价格升序；2 销量降序；3 价格降序 |
| min_order | int | 否 | 最小起批量过滤 | B 端批发业务传入，过滤大起订不适合铺货的工厂 |
二、七大完整业务场景落地（电商 ERP / 跨境 SaaS 直接复用）
场景 1：跨境电商选品溯源（Temu/Ozon/Coupang/ 独立站）
业务痛点：海外平台爆款图片，没有中文关键词，无法搜索国内货源；人工翻译关键词匹配效率低。
业务流程：
- 抓取海外平台商品主图；图片预处理（裁剪、压缩、去除水印）。
- 调用 1688.item_search_img，search_type=1，传入预估类目 cat_id。
- 本地过滤：筛选支持一件代发、可跨境发货、起订量符合铺货要求的工厂货源。
- 使用商品详情接口拉取 SKU、重量、材质，核算跨境利润。
- 输出候选货源清单，支持导出；低相似度结果人工复核。
典型产品：反向海淘系统、跨境选品工具、1688 采集上 Ozon/Temu 工具的识图找源模块。
场景 2：ERP 识图批量铺货（无货源店群）
业务痛点：运营拿到外网商品图，手动复制标题搜索 1688，录入参数效率极低。
业务流程：
- ERP 前端上传图片；图片预处理。
- API 图搜返回货源列表；运营选择合适货源。
- 自动回填标题、图片、规格参数；调用详情接口拿 SKU。
- 对接刊登 API，一键刊登到 Temu、Shopee、Ozon 等店铺。
风险提示：禁止完全全自动不经人工审核直接刊登；图片视觉相似不等于面料尺寸一致，容易大量售后退货；需要设置人工预审开关。
场景 3：竞品供应链监控调研
业务需求：定时抓取同行店铺上新主图，批量识图溯源上游 1688 供应商，监控竞品新款货源、批发成本。
架构要点：
- 异步任务队列，控制 QPS，禁止同步循环。
- Redis 缓存图片 MD5 对应的搜索结果，7‑15 天缓存，减少重复调用。
- 匹配到同款后，定时同步商品详情接口监控价格上涨、库存清零。
- 告警：竞品上新匹配到高潜力货源推送运营。
场景 4：企业 B 端采购、样品溯源比价
业务需求：展会样品实拍、客户发来样品图片，无货号，快速匹配多家工厂比价。
流程：图片上传→图搜→筛选工厂商家、阶梯报价、起订量；导出供应商对比报表，辅助采购决策。
场景 5：小红书 / 抖音爆款反向找货源
业务需求：短视频平台爆款商品截图，溯源 1688 源头，做国内无货源选品。
关键点：短视频截图质量差，预处理必须裁剪掉 UI 按钮水印；优先使用 search_type=1
无结果切换 search_type=2。
场景 6：舆情 & 仿品初筛（知识产权风控）
业务需求：输入自有品牌商品图，批量检索全网同款货源，快速发现仿款链接做初筛。
注意：API 仅做初筛，不能直接作为侵权判定依据，需要人工复核证据。
场景 7：客户报价系统识图找货（CRM / 销售报价系统）
业务需求：客户发来样品图片，销售一键识图匹配货源，快速生成报价单。 流程：客户上传图片→图搜匹配货源→自动带出批发价，结合运费、利润模板生成报价。
