前言

一、接口概述

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 字段,确保接口调用的健壮性。
五、应用场景示例
  • 商品展示:通过获取商品详情,在网站或应用中展示商品的基本信息、图片、价格等。
  • 数据分析:获取商品的销量、评价等数据,用于分析商品的市场表现和用户反馈。
  • 库存管理:实时获取商品的库存数量,帮助商家管理库存。
  • 价格比较:获取商品的价格信息,用于与其他平台或商家进行价格比较。
Logo

DAMO开发者矩阵,由阿里巴巴达摩院和中国互联网协会联合发起,致力于探讨最前沿的技术趋势与应用成果,搭建高质量的交流与分享平台,推动技术创新与产业应用链接,围绕“人工智能与新型计算”构建开放共享的开发者生态。

更多推荐