电商平台[淘宝|天猫|1688|京东|拼多多]图片搜索”接口获取数据全攻略
一、背景:为什么需要“以图搜款”
直播带货、社交电商、比价工具、ERP 选品、供应链爬虫都离不开“看到一张图,就能找到同款/相似款”的能力。各家官方把这项能力叫“拍立淘”“图搜”“拍照购”,但对外开放程度、接口形态、收费模式差异巨大。下文把 5 个主流平台的官方通道(含需申请)、替代方案、数据字段、Python 示例一次汇总,方便技术选型。
二、接口地图速览
平台 官方接口名称 是否需要资质 是否直接传图 主要返回字段 免费额度 备注
淘宝/天猫 item_search_img(拍立淘) 阿里妈妈开发者 + 单独权限 否,需先拿 material_id 标题、价格、销量、店铺、详情页链接 0(按调用量计费) 仅支持淘宝/天猫商品池
1688 item_search_img 企业实名 + 店铺评分 ≥4.5 支持图片 URL 或上传 商品标题、价格、起批量、供应商、相似度 500 次/日(免费版) B2B 属性,起订量字段完整
京东 imageSearch(联盟) 京东联盟 PID 支持直接上传 base64 SKU、主图、券后价、佣金比例 1 万次/日(联盟) 需申请“物料搜索”权限
拼多多 暂无公开图搜接口 —— —— —— —— 只能用关键词搜索后人工筛选
阿里云视觉智能 ProductSearch 实名 + 按量付费 支持直接上传 商品 ID、类目、置信度、自定义属性 500 次/月(试用) 通用图像搜索,可关联自家商品库
三、核心接口详解与代码
- 淘宝/天猫(拍立淘)
接口地址:https://api.taobao.com/imgsearch/item_search_img.do
调用前提
入驻阿里妈妈 → 创建媒体 → 申请 material_type=image 权限。
图片必须先调用 taobao.upload.image 得到 material_id,不能直接传本地文件 。
请求示例(Python)
import requests
APP_KEY = '你的app_key'
APP_SECRET = '你的secret'
MATERIAL_ID = '上传后返回的material_id'
url = 'https://api.taobao.com/imgsearch/item_search_img.do'
params = {
'app_key': APP_KEY,
'app_secret': APP_SECRET,
'material_id': MATERIAL_ID,
'cat': '', # 可选:类目ID
'page': 1
}
r = requests.get(url, params=params)
for item in r.json()['items']['item']:
print(item['title'], item['price'], item['detail_url'])
返回字段(JSON)
title price orginal_price sales num_iid nick pic_url detail_url is_tmall
2. 1688(阿里中文站)
接口地址:https://api-gw.onebound.cn/1688/item_search_img
特点
支持直接传图片 URL 或先用 upload_img 拿到 imgid。
返回供应商信息(公司名、诚信通年限、地区),适合做供应链爬虫。
代码片段
url = 'https://api-gw.onebound.cn/1688/item_search_img'
params = dict(
key='你的key',
imgid='http://example.com/sample.jpg',
page=1,
sort='sales_desc' # 销量排序
)
data = requests.get(url, params=params).json()
for it in data['items']:
print(it['title'], it['price'], it['match_rate'], it['company'])
免费版 500 次/日,超出需购买套餐 。
3. 京东(联盟图搜)
接口:https://api.jd.com/routerjson(method = jd.union.open.goods.material.search)
传参方式:image_bytes 直接放 base64,无需预上传。
返回:SKU、主图、券后价、佣金、计划类型。
调用限额:1 万次/日(联盟账号)。
官方文档入口
4. 拼多多
现状:2025 年仍无公开图片搜索 API。
曲线方案:
先用 OCR 识别图片中文字,得到关键词;
调用 pdd.goods.search 关键词搜索;
人工或算法对比主图相似度。
缺点:准确率依赖 OCR,无法找到无文字商品 。
5. 阿里云视觉智能(通用兜底)
若官方电商接口权限被拒,可用阿里云 ProductSearch 自建商品库搜索:
把自家或爬取的商品主图注册到实例;
调用 SearchProduct 上传图片即可返回相似商品 ID;
再关联回淘宝/天猫/京东的 num_iid 或 skuId。
按调用量计费,500 次/月免费 。
四、合规与避坑指南
版权问题:图片来源必须合法,禁止用他人版权图做训练或搜索。
反爬:淘宝、京东对无协议 UA、异常 IP 有滑块/封禁,需接入官方 SDK 并保持频率 ≤200 QPS。
数据回流:阿里妈妈接口返回的 click_url 含 pid,如替换或截取将违反《联盟规范》。
费用:淘宝/天猫按调用量 0.01–0.03 元/次;1688 套餐 100 元/万条;京东免费但需佣金分成。
拼多多:无官方接口,任何“拼多多图搜 API”均为第三方逆向,存在法律风险 。
五、选型建议
To C 导购/比价:优先淘宝 item_search_img,字段全、佣金链路完整。
B2B 找工厂:1688 图搜,起订量、供应商信保字段一步到位。
京东pop店选品:京东联盟图搜,可顺带拿佣金比例。
多平台统一搜索:阿里云视觉自建库,再映射各平台商品 ID,规避单平台政策风险。
六、结语
电商图搜接口没有“万能钥匙”,必须根据业务场景、资质、预算权衡。淘宝/天猫数据最丰富但门槛最高;1688 供应链深度最好;京东适合带券商品;拼多多暂无官方方案。理解各家规则后,再决定是否混合自建库,才能在合规前提下把“以图搜款”真正落地。
如遇任何疑问或有进一步的需求,请随时与我私信或者评论联系。
浙公网安备 33010602011771号