商品信息管理｜快工助手

stable本次发布有变化全部展示

来自 Shopee 官方资料快照 · 2026-09-06 12:16:05

打开官方原文 ↗

当前资料结构化阅读页
固定快照已留存，可追溯
官方原文可核对

查看技术与溯源信息

平台 / profile: Shopee / profile.shopee.developer_guide
语言: zh-Hans
发布版本: cn-20260909-2
标签: zhuge/sourceplatform/shopeeaudience/developercategory/api_doctopic/apitopic/api-guidelines-and-flowstopic/developer

资料正文

§1 1. 获取商品列表

§2 1.1 获取所有店铺商品

1.1 获取所有店铺商品

调用接口：v2.product.get_item_list

这个接口支持您获取店铺所有商品ID列表，或者通过更新时间范围和状态进行筛选。

§3 1.2 根据特定条件搜索商品

1.2 根据特定条件搜索商品

调用接口：v2.product.search_item

这个接口支持您根据一些特定条件搜索商品ID列表，条件包括：

包含商品名称关键词的商品ID列表
包含sku关键词的商品ID列表
缺乏必填属性的商品ID列表
缺乏选填属性的商品ID列表

§4 2. 获取商品基础信息

调用接口：v2.product.get_item_base_info + v2.product.get_model_list

如果商品不包含变体，您只需要调用v2.product.get_item_base_info即可获取到商品基础信息和商品库存价格信息，否则还需要同时调用v2.product.get_model_list接口获取变体的库存价格信息，v2.product.get_item_base_info API 中的“has_model”字段表示产品是否有变体。

§5 3. 获取商品数据

调用接口：v2.product.get_item_extra_info

这个接口可以获取商品浏览量、点赞数、销量、评价数量、评价星级数据。

浏览量数据为最近30天统计值，销量数据为累计值。

§6 4. 获取商品活动信息

调用接口：v2.product.get_item_promotion

这个接口可以获取到商品参与的所有进行中或即将开始的活动信息。如果商品同时参与了多种活动，v2.product.get_item_base_info 的promotion_id字段将返回其中一种活动ID，建议您继续调用接口v2.product.get_item_promotion拿完整的活动信息数据。

§7 5. 更新商品信息

调用接口：v2.product.update_item

1.这个接口支持更新除了size_chart/price/stock/变体的商品信息。被上传字段都将会被更新，不被上传的字段将不更新。

2.对于item_sku/wholesale/video_upload_id 我们支持删除操作，您可以上传空字符串即可实现删除。

删除item_sku的请求参数例子：

{

"item_id": 800182459,

"item_sku": ""

}

3.更新富文本商品描述注意事项，请参考FAQ。

4.如果您在更新商品时并没有上传某些字段，但是遇到了提示这些字段填写错误，这种情况是正常的，因为每次您的更新，我们都会全量校验商品信息合法性，所以如果不符合要求，请您修改。

§8 6. 商品上下架和删除

调用接口：v2.product.unlist_item

如果传unlist=true, 表示将商品下架，如果传unlist=false,表示将商品重新上架。

调用接口：v2.product.delete_item

这个接口可以将商品状态改为删除，请注意，删除商品后，将不可以再进行商品更新操作，而且卖家也无法通过卖家中心查看到。对于Shopee deleted 和Seller deleted的商品，在90天内，您仍然可以通过接口获取到商品信息，在90天之后，商品数据将在数据库中永久删除，您无法查询到此商品的任何信息，如果您有需要，请及时保存商品信息。