×

淘宝京东1688店铺所有商品API接口系列,json数据返回

admin admin 发表于2025-08-01 15:48:16 浏览26 评论0

抢沙发发表评论

以下是淘宝、京东、1688店铺所有商品API接口的JSON数据返回结构及关键字段说明,适用于电商平台数据同步、商品管理系统开发等场景:

一、淘宝店铺所有商品API接口

接口名称taobao.shop.items.get
功能:根据店铺ID获取店内所有商品基础信息(标题、价格、库存、主图等),支持分页查询。
请求参数示例

json{"app_key": "你的AppKey","method": "taobao.shop.items.get","timestamp": "2025-08-01 15:48:00","format": "json","v": "2.0","shop_id": "123456789",  // 店铺ID"page_no": 1,           // 页码"page_size": 50,        // 每页商品数(最大100)"fields": "num_iid,title,price,stock,image_url"  // 需返回的字段}

JSON数据返回示例

json{"items": {"item": [{"num_iid": "112233445566",  // 商品ID"title": "夏季新款纯棉T恤 男女通用",  // 商品标题"price": "59.90",           // 价格(元)"stock": 100,               // 库存"image_url": "https://img01.taobao.com/xxx.jpg",  // 主图URL"create_time": "2025-05-15 09:30:00",  // 创建时间"shop_id": "123456789"      // 店铺ID},{"num_iid": "223344556677","title": "休闲牛仔裤 显瘦百搭","price": "89.00","stock": 50,"image_url": "https://img02.taobao.com/yyy.jpg","create_time": "2025-05-20 14:15:00","shop_id": "123456789"}]},"total_results": 200,  // 总商品数"page_no": 1,         // 当前页码"page_size": 50        // 每页商品数}

关键字段说明

  • num_iid:商品唯一ID。

  • title:商品标题(含关键词,影响搜索排名)。

  • price:当前售价(部分接口返回original_price原价)。

  • stock:库存数量(部分商家可能隐藏实时库存)。

  • image_url:商品主图URL,支持多角度展示。

二、京东店铺所有商品API接口

接口名称jd.union.open.shop.goods.get
功能:根据店铺ID获取店内所有商品信息(名称、价格、库存、图片等),支持分页和排序。
请求参数示例

json{"app_key": "你的AppKey","method": "jd.union.open.shop.goods.get","timestamp": "2025-08-01 15:48:00","format": "json","v": "2.0","shop_id": "123456",  // 店铺ID"page": 1,           // 页码"page_size": 50      // 每页商品数}

JSON数据返回示例

json{"code": "200","message": "success","data": {"goods_list": [{"sku_id": "100012345678",  // 商品ID"name": "华为Mate 50 Pro 5G手机",  // 商品名称"price": 5999.00,           // 当前价格"original_price": 6999.00,  // 原价"image_path": "https://img10.360buyimg.com/n1/s450x450_jfs/t1/123456/78/12345/123456/12345678/1234567890abcdef.jpg",  // 主图URL"stock_state": 1,           // 库存状态(1-有货,0-无货)"sale_num": 1000,           // 销量"comment_num": 500,         // 评价数"positive_rate": "95%"       // 好评率},{"sku_id": "100012345679","name": "华为Mate 50 5G手机","price": 4999.00,"original_price": 5999.00,"image_path": "https://img10.360buyimg.com/n1/s450x450_jfs/t1/123456/78/12345/123456/12345678/1234567890abcde1.jpg","stock_state": 1,"sale_num": 800,"comment_num": 300,"positive_rate": "93%"}]}}

关键字段说明

  • sku_id:商品唯一ID。

  • name:商品名称。

  • price:当前价格。

  • original_price:原价。

  • stock_state:库存状态(1-有货,0-无货)。

  • sale_num:销量。

  • comment_num:评价数。

  • positive_rate:好评率。

三、1688店铺所有商品API接口

接口名称1688.shop.items.get
功能:根据店铺ID获取店内所有商品信息(名称、价格、库存、图片、规格等),支持分页和排序。
请求参数示例

json{"app_key": "你的AppKey","method": "1688.shop.items.get","timestamp": "2025-08-01 15:48:00","format": "json","v": "2.0","store_id": "123456789",  // 店铺ID"page_number": 1,         // 页码"page_size": 50           // 每页商品数}

JSON数据返回示例

json{"status": "success","result": {"products": [{"product_id": "610947572360",  // 商品ID"product_name": "韩版仿兔毛围巾秋冬毛毛围巾",  // 商品名称"price": "2.2",               // 价格"original_price": "25.00",    // 原价"pic_url": "https://img.1688.com/img/xxxxxx.jpg",  // 主图URL"stock": 1000,                // 库存"sales": 500,                 // 销量"positive_rate": "97.8%",    // 好评率"sku_list": [                 // SKU列表{"sku_id": "123456789","price": "15.00","stock": 100,"attribute_combination": "红色-M"  // 规格描述}],"supplier": {                 // 供应商信息"supplier_id": "987654321","supplier_name": "某供应商","contact_person": "张三","contact_phone": "13800138000"}},{"product_id": "610947572361","product_name": "韩版仿羊绒围巾秋冬保暖围巾","price": "3.5","original_price": "30.00","pic_url": "https://img.1688.com/img/xxxxxx1.jpg","stock": 800,"sales": 400,"positive_rate": "96.5%","sku_list": [{"sku_id": "123456790","price": "18.00","stock": 80,"attribute_combination": "黑色-L"}],"supplier": {"supplier_id": "987654322","supplier_name": "另一供应商","contact_person": "李四","contact_phone": "13900139000"}}]},"error_code": "0","error_msg": "成功"}

关键字段说明

  • product_id:商品唯一ID。

  • product_name:商品名称。

  • price:当前价格。

  • original_price:原价。

  • stock:库存数量。

  • sales:销量。

  • positive_rate:好评率。

  • sku_list:SKU列表(含价格、库存、规格描述)。

  • supplier:供应商信息(ID、名称、联系人、电话)。



群贤毕至

访客