前言

一、接口概述

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，用于追踪请求。

四、接口调用注意事项

1. 权限要求：需申请对应 API 权限（如 items:read）。
2. 频率限制：通常 QPS 限制为 60 次/分钟，需遵守平台限流规则。
3. 站点区分：不同国家站点需使用对应的 shop_id 和 partner_id。
4. 数据延迟：部分字段（如库存）可能存在缓存延迟。
5. 错误处理：需检查 HTTP 状态码和返回数据中的 error 字段，确保接口调用的健壮性。

五、应用场景示例

• 商品展示：通过获取商品详情，在网站或应用中展示商品的基本信息、图片、价格等。
• 数据分析：获取商品的销量、评价等数据，用于分析商品的市场表现和用户反馈。
• 库存管理：实时获取商品的库存数量，帮助商家管理库存。
• 价格比较：获取商品的价格信息，用于与其他平台或商家进行价格比较。