查询商品列表

GET#69api SHOP_COMMODITY_INFO

https://member.bilibili.com/arcopen/fn/v2/market/commodity/item/list

开放能力 / 交易电商 / 电商 / 接口 / 商品模块接口

调用该接口可获取商品分页信息

url 参数

名称	类型	必填	说明
items_ids	[]int	否	商品ID批量查询条件
start_update_time	int	否	商品更新起始时间，时间戳毫秒
end_update_time	int	否	商品更新结束时间，时间戳毫秒
status	int	否	商品上下架状态 0 待上架 1 已上架 2 已下架
recycling_status	int	否	商品删除状态 0 未删除 1 已删除
page_num	int	是	分页页码，从1开始
page_size	int	是	分页大小，最大50

响应字段

名称	类型	必填	说明
list	List	是	类目列表
items_id	int	是	商品ID
name	string	是	商品标题
images	[]string	是	商品头图，头图第一张作为主图
status	int	是	商品上下架状态 0 待上架 1 已上架 2 已下架
recycling_status	int	是	商品删除状态 0 未删除 1 已删除
create_time	int	是	商品创建时间，时间戳毫秒商品创建时间，时间戳毫秒
update_time	int	是	商品更新时间，时间戳毫秒商品更新时间，时间戳毫秒
delivery_time	int	否	发货时间
sale_step	int	是	销售阶段 0 现货 2 定金预售 3 待开启补款 4 尾款中 41 尾款中已开现货 5 待开启现货 7 全款预售
skus	List	是	SKU信息
sku_id	int	是	SKU_ID
image	string	是	SKU图片
shop_code	string	否	商家编码
sn	string	是	国际条码
price	int	是	SKU售价，单位分
sku_specs	List	是	SKU规格信息
spec_key_name	string	是	规格名
spec_value_name	string	是	规格值
total	int	是	总结果数量
page_num	int	是	当前页码
page_size	int	是	当前分页大小
size	int	是	当前页结果数量
pages	int	是	总页数
has_next_page	bool	是	是否还有下一页

调用方式

javascript

// 让 AI 直接调（需要开放平台凭据）
bili_api_call { "ref": "69", "query": {…}, "body": {…} }

// 只看将要发出的请求（不需要凭据）
bili_api_call { "ref": "69", "dryRun": true }

// 生成完整调用代码
bili_codegen { "ref": "69", "lang": "python" }

原始文档：069_查询商品列表.md（3887 字节）。用 bili_docs_get { "ref": "69" } 读全文，或用 bili_api_spec { "ref": "69" } 取结构化规格。