首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >技术实战:速卖通商品详情API接入指南与JSON返回参考

技术实战:速卖通商品详情API接入指南与JSON返回参考

原创
作者头像
Anzexi58
发布2026-08-18 16:59:07
发布2026-08-18 16:59:07
1730
举报
文章被收录于专栏:API接口开发API接口开发

前言

在跨境出海选品、全球价格监控、多站点铺货的业务场景中,速卖通商品详情API是跨境电商从业者最核心的结构化数据入口。它无需搭建复杂的海外代理与反爬体系,就能稳定获取全维度的速卖通全球站点商品信息,大幅降低跨境选品、竞品分析类业务的开发门槛,是打通速卖通货源数据与自有跨境ERP系统的必备工具。

一、接口核心覆盖的数据范围

这套接口可以返回跨境电商业务开发中几乎所有需要的速卖通商品核心字段,完全适配全球选品、价格监控、竞品分析等多种场景:

  1. 基础标识:商品ID、商品多语言标题、所属店铺ID、店铺名称、商家入驻类型、商品上架时间、所属类目路径
  2. 价格体系:基础售价、不同国家/地区专属定价、平台大促活动价、优惠券抵扣金额、新人专享价,所有价格数据支持分钟级更新
  3. 交易属性:30天累计销量、历史销量趋势、商品好评率、总评价数、店铺DSR评分、近7天访客数
  4. 规格库存:全SKU变体列表、每个子变体的对应价格、实时可售库存、颜色/尺寸/型号等属性明细、是否支持海外仓发货
  5. 素材资源:多尺寸主图数组、详情图列表、A+页面素材链接、商品主视频地址、多语言详情描述资源
  6. 附加信息:商品参数详情、物流配送时效预估、平台服务保障标识、关联捆绑商品信息、商品原产地、支持的物流方式列表

二、最简接入操作步骤

结合之前亚马逊、1688等电商接口的开发经验,新手跟着3步就能快速完成适配调用:

  1. 登录速卖通开放平台,注册开发者账号,创建应用并申请商品详情查询权限,获取专属的App Key和App Secret(o0b.cn/anzexi)
  2. 按照官方规范生成合法签名,将所有非空请求参数按字典序排序后拼接密钥,通过MD5加密生成验签值
  3. 用HTTPS POST方式将请求提交到速卖通API网关,传入目标商品ID,即可直接返回标准JSON格式的结构化商品数据

三、可直接参考的成功返回JSON示例

这是脱敏后的标准返回结构,完全匹配速卖通开放平台官方商品详情接口的原生返回格式,核心字段都标注了业务含义,可直接用于开发调试参考:

代码语言:javascript
复制
{
  "code": 200,
  "msg": "success",
  "request_id": "req_2026081611223745",
  "data": {
    "product_id": 1000789654321,
    "multi_lang_title": {
      "en": "2026 New Portable Wireless Vacuum Cleaner 12000Pa Strong Suction Handheld Car Home Dual Use",
      "ru": "Портативный беспроводной пылесос 12000Pa для дома и автомобиля",
      "es": "Aspiradora inalámbrica portátil 12000Pa para coche y hogar"
    },
    "shop_info": {
      "shop_id": 2000123456,
      "shop_name": "Home Appliance Direct Store",
      "company_name": "深圳智能家居源头工厂",
      "dsr_score": {
        "item_score": 4.8,
        "service_score": 4.7,
        "delivery_score": 4.8
      },
      "is_gold_supplier": true
    },
    "price_info": {
      "base_price": "29.99",
      "currency": "USD",
      "country_specific_price": {
        "RU": "24.99",
        "ES": "27.99"
      },
      "promotion_price": "19.99",
      "coupon_price": "16.99",
      "promotion_desc": "Summer Sale 33% OFF Limited Time Offer"
    },
    "sales_info": {
      "month_sales": 23680,
      "total_orders": 156890,
      "good_rate": "96.8%",
      "total_reviews": 8960,
      "category_path": "Home Appliances > Vacuum Cleaners"
    },
    "stock_info": {
      "total_stock": 126000,
      "is_on_sale": true,
      "support_warehouse": ["CN", "RU", "ES"],
      "min_order_quantity": 1
    },
    "image_info": {
      "main_images": [
        "https://ae01.alicdn.com/kf/Ha1b2c3d4e5f6g7h8i9j.jpg",
        "https://ae01.alicdn.com/kf/Hj9i8h7g6f5e4d3c2b1a.jpg",
        "https://ae01.alicdn.com/kf/Hz1x2y3w4v5u6t7s8r9.jpg"
      ],
      "detail_images": [
        "https://ae01.alicdn.com/kf/Hq1w2e3r4t5y6u7i8o9p.jpg",
        "https://ae01.alicdn.com/kf/Ha0s9d8f7g6h5j4k3l2m.jpg"
      ],
      "video_url": "https://ae01.alicdn.com/video/xyz12345.mp4"
    },
    "sku_list": [
      {
        "sku_id": 100078965432101,
        "spec_text": "Standard Version White",
        "sku_price": "29.99",
        "sku_stock": 46000
      },
      {
        "sku_id": 100078965432102,
        "spec_text": "Pro Version Black",
        "sku_price": "39.99",
        "sku_stock": 80000
      }
    ],
    "product_params": [
      {"name": "Suction Power", "value": "12000Pa"},
      {"name": "Battery Life", "value": "30 Mins"},
      {"name": "Charging Port", "value": "Type-C"}
    ],
    "logistics_info": {
      "supported_methods": ["AliExpress Standard Shipping", "ePacket", "DHL"],
      "estimated_delivery": "7-15 Days",
      "free_shipping_threshold": "15.00"
    },
    "after_sale": {
      "support_return": true,
      "return_days": 15,
      "warranty_months": 12,
      "guarantee_tags": ["On-time Delivery", "Refund if not received"]
    }
  }
}

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

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

目录
  • 前言
  • 一、接口核心覆盖的数据范围
  • 二、最简接入操作步骤
  • 三、可直接参考的成功返回JSON示例
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档