一、接入前的准备工作
一、接口基础能力（数据底层能力）1. 请求参数
1.1 图片硬性规范（直接影响图片搜索匹配准确率，开发接入时必须做好预处理）
项目 | 规范 | 禁忌 |
|---|---|---|
格式 | JPG/JPEG、PNG | GIF、WebP、透明底 PNG、拼接图、长截图 |
大小 | ≤1MB，最大不得超过 4MB | 原图超过 5MB 会直接触发 413 超限错误 |
分辨率 | 最短边≥256px；推荐 720‑800px | 缩略图、小尺寸图片、模糊截图会导致匹配率明显下降 |
画面 | 商品主体居中，主体占画面＞60%；尽量减少水印和杂物 | 大面积水印、多商品混拍、背景杂乱、纯文字图片 |
1.2 请求基础信息
接口名称：tb.item_search_img（淘宝图片搜索 API，taobaoapi2014 可前往体验）
请求网关： c0b.cc/R4rbK2 （HTTPS，支持 GET/POST）
接口版本：2.0
鉴权方式：AppKey AppSecret 签名校验（MD5/HMAC-SHA256）
调用限制：接口存在每秒调用频次限制和每日调用配额，高并发业务场景建议配合限流与缓存机制。
核心作用：根据商品 ID 获取商品标题、价格、SKU、库存、图文详情、类目、销量、规格属性等完整商品数据。
num_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 端批发采购场景建议传入，用于过滤起订量过高、不适合铺货的工厂 |
二、标准返回 JSON 示例
json
代码语言：ja vascript复制{"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}}]}}
本地二次过滤规则（业务层必须实现）
similar_score 的相似度阈值，业务上建议设置为 ≥0.7；凡是低于 0.7 的搜索结果，直接过滤会更稳妥，这样可以尽量避开“看起来相似、实物却完全不同”的干扰项。除此之外，还应继续过滤：min_order 超出业务可接受起订量的商品需要排除；非优质商家、低销量商品也建议同步筛掉。排序优先级建议如下：先按相似度降序，再优先展示工厂店，然后按销量降序，最后按价格升序。去重步骤同样不能忽略，同一个商品只保留一条即可，因为图片搜索接口本身可能返回重复商品。三、七大完整业务场景落地（电商 ERP / 跨境 SaaS 可直接复用）
场景 1：跨境电商选品溯源（Temu/Ozon/Coupang/ 独立站）
业务痛点非常明确：海外电商平台上的爆款商品通常只有商品图片，没有中文关键词，导致国内 1688 货源很难精准搜索；如果依赖人工翻译后再做关键词检索，不仅效率低，匹配准确率也难以保障。
业务流程：
抓取海外平台商品主图；进行图片预处理（裁剪、压缩、去除水印）。调用1688.item_search_img，search_type=1，并传入预估类目 cat_id。本地过滤：筛选支持一件代发、支持跨境发货、起订量符合铺货要求的工厂货源。再使用商品详情接口拉取 SKU、重量、材质等信息，进一步核算跨境利润。最终输出候选货源清单，支持导出；对于低相似度结果，建议人工复核。场景 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：舆情 & 仿品初筛（知识产权风控）
业务需求：输入自有品牌商品图片，批量检索全网同款货源，快速发现疑似仿款链接，用于知识产权风控初筛。
场景 7：客户报价系统识图找货（CRM / 销售报价系统）
业务需求：客户发送样品图片后，销售可一键识图匹配货源，并快速生成报价单。流程：客户上传图片→图搜匹配货源→自动带出批发价，结合运费与利润模板自动生成报价。
