虾皮（Shopee）商品详情 API 接口概述及 JSON 数据返回参考
前言
一、接口概述
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字段，确保接口调用的健壮性。
五、应用场景示例
- 商品展示：通过获取商品详情，在网站或应用中展示商品的基本信息、图片、价格等。
- 数据分析：获取商品的销量、评价等数据，用于分析商品的市场表现和用户反馈。
- 库存管理：实时获取商品的库存数量，帮助商家管理库存。
- 价格比较：获取商品的价格信息，用于与其他平台或商家进行价格比较。