1688拍立淘图片搜索API接口解析（附 JSON 样例）

原创

用户1597063760

发布于 2026-09-17 15:27:53

210

文章被收录于专栏：经验经验

前言：在跨境选品、货源溯源、竞品监控场景中，经常需要根据一张商品图片，快速查找 1688 平台同款 / 相似 B2B 货源。自建图像检索库成本高、维护复杂，而 1688 开放平台的拍立淘图片检索 API，直接依托平台 CV 模型完成图片检索，返回结构化批发货源数据。本文从接口能力、请求参数、返回字段、JSON 样例以及开发踩坑点完整解析。

一、接口基础概述

接口名称：1688.item_search_img（俗称 1688 拍立淘图片搜索 API，官方别名 alibaba.image.search.offer.match）协议：HTTPS 请求方式：POST（推荐，支持 Base64 图片）、GET（仅支持公网图片 URL） 鉴权方式：AppKey + AppSecret + MD5 签名 能力简介：传入商品图片（公网 URL / Base64 编码），基于深度学习图像特征检索，返回 1688 平台同款、相似批发商品列表，B 端专属字段包含起订量、阶梯价、工厂标识、一件代发标签等，区别于淘宝 C 端拍立淘接口。

适用业务场景

跨境电商选品：海外平台图片反向查找 1688 源头工厂货源
竞品监控：竞品商品图溯源，比价、监控供应商价格变动
供应链采购：图片快速找货，批量筛选产业带工厂
商品素材匹配：素材图片校验 1688 同款货源

请求基础信息

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

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

接口版本：2.0

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

权限前置说明 接口需要企业开发者认证，创建开放平台应用后单独申请接口白名单；个人开发者无法申请该接口权限，调用存在 QPS 限流、额度限制。

图片规范（开发必看）

格式：JPG / PNG，不支持 GIF、WebP
大小：建议≤2MB，图片过大容易超时、识别失败
分辨率：最小边≥256px，主体清晰，减少背景杂物，提升相似度准确率

二、核心请求参数

参数名	是否必传	类型	说明
app_key	是	String	开放平台应用密钥
sign	是	String	参数 MD5 签名，用于接口鉴权
timestamp	是	String	时间戳，防重放攻击
image	二选一	String	图片 Base64 编码，POST 方式推荐
image_url	二选一	String	公网可直接访问图片 URL，GET 方式使用
page	否	Int	页码，默认 1
page_size	否	Int	每页返回条数，最大 50
similar_degree	否	Float	相似度过滤阈值 0~1，推荐 0.75（高于该值判定同款）

三、返回 JSON 样例

{
    "code": "0",
    "msg": "success",
    "request_id": "20260917144200123456",
    "data": {
        "items": {
            "total_results": 46,
            "page": 1,
            "page_size": 10,
            "pagecount": 5,
            "item": [
                {
                    "num_iid": "634209995336",
                    "title": "加厚毛巾底运动短袜 吸汗透气无骨棉袜 工厂现货批发",
                    "pic_url": "https://cbu01.alicdn.com/img/ibank/2020/490/610/23562016094_1701667707.jpg",
                    "price": "3.00",
                    "price_range": {
                        "min_price": "2.50",
                        "max_price": "4.20"
                    },
                    "similarity": 0.86,
                    "sales30d": 1600,
                    "minOrderQuantity": 100,
                    "is_factory": true,
                    "one_psale": true,
                    "is_jxhy": true,
                    "sellerName": "XX棉织品有限公司",
                    "sellerArea": "浙江义乌",
                    "detail_url": "https://detail.1688.com/offer/634209995336.html"
                },
                {
                    "num_iid": "634209995337",
                    "title": "纯色运动棉袜 男女同款短筒袜 多色可选批量拿货",
                    "pic_url": "https://cbu01.alicdn.com/img/ibank/xxxx.jpg",
                    "price": "3.20",
                    "price_range": {
                        "min_price": "2.80",
                        "max_price": "4.50"
                    },
                    "similarity": 0.72,
                    "sales30d": 860,
                    "minOrderQuantity": 200,
                    "is_factory": false,
                    "one_psale": false,
                    "is_jxhy": false,
                    "sellerName": "XX贸易商行",
                    "sellerArea": "江苏苏州",
                    "detail_url": "https://detail.1688.com/offer/634209995337.html"
                }
            ]
        }
    }
}

四、返回核心字段释义

字段	说明
code	状态码，0 = 成功；非 0 代表异常（权限不足、图片非法、限流）
msg	返回提示信息，排查接口报错使用
request_id	请求唯一 ID，线上日志排查
total_results	检索匹配到的商品总数
page / page_size	当前页码、每页条数，用于分页遍历
num_iid	1688 商品 offerId，唯一 ID，可传入商品详情 API 获取 SKU、库存
title	商品批发标题
pic_url	商品主图地址
price	挂牌基础批发价
price_range	阶梯价格区间，批量采购成本核算
similarity	图像相似度 0~1，≥0.75 推荐判定为同款，0.6~0.75 相似款，低于 0.6 建议过滤
sales30d	近 30 天批发销量，评估款式热度
minOrderQuantity	MOQ 最小起订量，B 端核心筛选字段
is_factory	是否源头工厂
one_psale	是否支持一件代发，跨境业务常用筛选
sellerName	供应商名称
sellerArea	产地 / 产业带
detail_url	商品详情页链接

五、开发落地避坑要点

图片预处理：图片主体尽量居中，裁剪多余背景；背景杂乱会大幅降低相似度分数，出现大量无关结果。
相似度过滤：不要直接全量使用返回结果，业务层增加 similarity 阈值过滤，减少人工复核工作量。
限流控制：该接口 QPS 限制严格，批量图搜务必增加请求间隔，高频调用会触发 429 限流。
图片地址要求：使用图片 URL 方式调用时，图片公网服务器不能设置防盗链，否则接口无法拉取图片识别。
数据二次拉取：图搜接口只返回基础信息，如需 SKU、库存、属性，需要拿着 num_iid 调用 1688 商品详情 API。

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

开发经验