虾皮(Shopee)商品详情 API 接口概述及 JSON 数据返回参考
Shopee 商品详情 API 接口是 Shopee 平台为开发者提供的,用于获取商品详细信息的接口服务。通过该接口,开发者可以获取商品的标题、价格、库存、描述、图片、规格参数、销量、评价等详细信息。这些数据为电商数据分析、商品比价工具开发、店铺管理系统等应用场景提供了全面支持。主要功能精准获取商品信息:根据商品 ID 精确返回对应商品的详细信息,避免数据混淆。数据全面性:提供丰富的商品相关信息,
·
前言
一、接口概述
Shopee 商品详情 API 接口是 Shopee 平台为开发者提供的,用于获取商品详细信息的接口服务。通过该接口,开发者可以获取商品的标题、价格、库存、描述、图片、规格参数、销量、评价等详细信息。这些数据为电商数据分析、商品比价工具开发、店铺管理系统等应用场景提供了全面支持。
主要功能:
- 精准获取商品信息:根据商品 ID 精确返回对应商品的详细信息,避免数据混淆。
- 数据全面性:提供丰富的商品相关信息,涵盖基本属性、销售数据、促销活动等。
- 实时性:返回的商品信息通常是实时更新的,确保开发者获取到最新的商品状态。
使用场景:
- 电商数据分析:通过获取商品详情数据,分析市场趋势、用户需求、商品竞争情况等。
- 商品比价工具:实时跟踪竞品价格变化,为用户提供最优购买渠道。
- 店铺管理系统:同步多平台库存,避免超卖,优化运营策略。
二、JSON 数据返回参考
以下是一个典型的 Shopee 商品详情 API 接口返回的 JSON 数据示例:
{ |
|
"item": { |
|
"item_id": 123456789, |
|
"name": "无线蓝牙耳机降噪运动跑步耳机", |
|
"price": 299.9, |
|
"currency": "CNY", |
|
"stock": 50, |
|
"description": "高清音质,IPX5防水,超长续航30小时,支持蓝牙5.0", |
|
"images": [ |
|
"https://cf.shopee.cn/file/123456789/123456789_123456789.jpg", |
|
"https://cf.shopee.cn/file/123456789/123456789_123456790.jpg" |
|
], |
|
"category_id": 12345, |
|
"category_name": "消费电子 > 耳机 > 蓝牙耳机", |
|
"seller_info": { |
|
"shop_id": 987654321, |
|
"shop_name": "数码旗舰店", |
|
"rating": 4.8, |
|
"follower_count": 15000 |
|
}, |
|
"attributes": [ |
|
{ |
|
"name": "颜色", |
|
"value": ["黑色", "白色", "蓝色"] |
|
}, |
|
{ |
|
"name": "保修期", |
|
"value": ["12个月"] |
|
} |
|
], |
|
"shipping_info": { |
|
"free_shipping": true, |
|
"shipping_fee": 0, |
|
"days_to_ship": "3-5天" |
|
}, |
|
"promotions": [ |
|
{ |
|
"type": "discount", |
|
"value": "20%", |
|
"start_time": "2023-10-01 00:00:00", |
|
"end_time": "2023-10-31 23:59:59" |
|
} |
|
], |
|
"ratings": { |
|
"count": 450, |
|
"average": 4.7 |
|
} |
|
}, |
|
"error": null, |
|
"request_id": "123e4567-e89b-12d3-a456-426614174000" |
|
} |
三、关键字段说明
| 字段名 | 类型 | 描述 |
|---|---|---|
item_id |
Integer | 商品唯一标识 ID。 |
name |
String | 商品名称。 |
price |
Float | 商品当前售价(单位由 currency 字段决定)。 |
currency |
String | 货币代码(如 CNY、USD 等)。 |
stock |
Integer | 库存数量(-1 表示无限制)。 |
description |
String | 商品描述(HTML 格式)。 |
images |
Array | 商品图片 URL 列表。 |
category_id |
Integer | 商品所属分类 ID。 |
category_name |
String | 商品所属分类名称。 |
seller_info |
Object | 店铺信息(包含店铺 ID、名称、评分等)。 |
attributes |
Array | 商品属性(如品牌、型号、颜色等)。 |
shipping_info |
Object | 物流信息(是否包邮、运费等)。 |
promotions |
Array | 促销活动信息(如折扣、满减等)。 |
ratings |
Object | 用户评分数据(总评分、带图评价数等)。 |
error |
Object | 错误信息(如有错误时返回)。 |
request_id |
String | 请求唯一标识 ID,用于追踪请求。 |
四、接口调用注意事项
- 权限要求:需申请对应 API 权限(如
items:read)。 - 频率限制:通常 QPS 限制为 60 次/分钟,需遵守平台限流规则。
- 站点区分:不同国家站点需使用对应的
shop_id和partner_id。 - 数据延迟:部分字段(如库存)可能存在缓存延迟。
- 错误处理:需检查 HTTP 状态码和返回数据中的
error字段,确保接口调用的健壮性。
五、应用场景示例
- 商品展示:通过获取商品详情,在网站或应用中展示商品的基本信息、图片、价格等。
- 数据分析:获取商品的销量、评价等数据,用于分析商品的市场表现和用户反馈。
- 库存管理:实时获取商品的库存数量,帮助商家管理库存。
- 价格比较:获取商品的价格信息,用于与其他平台或商家进行价格比较。
DAMO开发者矩阵,由阿里巴巴达摩院和中国互联网协会联合发起,致力于探讨最前沿的技术趋势与应用成果,搭建高质量的交流与分享平台,推动技术创新与产业应用链接,围绕“人工智能与新型计算”构建开放共享的开发者生态。
更多推荐

所有评论(0)