×

淘宝/天猫图片搜索API接口,json返回数据。

万邦科技Lex 万邦科技Lex 发表于2025-08-22 14:49:17 浏览343 评论0

抢沙发发表评论

注册万邦平台账号免费测试淘宝/天猫API接口

淘宝 / 天猫平台未直接开放公开的 “图片搜索” API 接口,但可通过以下两种方式实现类似功能:

1.  **阿里妈妈淘宝联盟 API**:支持通过图片相关参数(如图片 URL)搜索相似商品(需申请权限);

1.  **天猫开放平台接口**:针对商家的图片搜索接口(需企业资质和授权)。

以下基于淘宝联盟的相关接口(非直接图片搜索,但可通过图片参数关联商品),提供 Curl 调用示例及 JSON 响应格式说明。

 淘宝联盟图片相关商品搜索 API(Curl 示例)

该接口通过图片特征参数搜索相似商品,需先在阿里妈妈开放平台申请接口权限。

替换参数说明:

 app_key:你的应用appkey

 sign:按阿里妈妈签名规则生成的签名

 material_id:图片相关标识(可通过图片上传接口获取)

 material_type:类型为"image"

 timestamp:当前时间戳(格式:yyyy-MM-dd HH:mm:ss)

curl -X GET "https://eco.taobao.com/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://img.alicdn.com/imgextra/i1/xxx.jpg",  // 商品主图
          "small_images": {
            "string": [
              "https://img.alicdn.com/imgextra/i2/xxx.jpg",
              "https://img.alicdn.com/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://img.alicdn.com/imgextra/i4/xxx.jpg",
          "zk_final_price": "59.00",
          "sales": 890,
          "shop_title": "YY男装专营店"
        }
      ]
    },
    "total_count": 2,  // 总条数
    "has_more": true  // 是否有下一页
  }}

关键说明

  1. 接口限制
    • 需通过阿里妈妈开发者认证,且material_type=image的调用权限需单独申请;

    • 无法直接传入本地图片,需先通过图片上传接口(如taobao.upload.image)获取material_id

  2. 替代方案
    • 若需纯图片搜索(如拍照搜商品),可使用阿里云视觉智能开放平台的 “商品搜索” API(需付费,支持图片直接上传),其结果可关联淘宝 / 天猫商品。

  3. 合规性
    • 所有接口调用需遵守《阿里妈妈推广者规范》,禁止用于爬取或侵权用途;

    • 图片来源需合法,避免侵犯知识产权。


如需更高精度的图片搜索,建议优先对接阿里云视觉智能 API,再通过商品 ID 关联淘宝 / 天猫的商品详情。

群贤毕至

访客