以下是淘宝、京东、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、名称、联系人、电话)。