微店商品列表 API 返回数据通常为 JSON 格式，包含商品基础信息、库存、价格、分类等核心字段。以下从数据结构解析、关键字段说明、解析示例三个维度，详解如何高效提取和利用这些数据：
一、整体数据结构
微店商品列表 API（通常对应vdian.item.list.get接口）的返回数据分为三层：状态层、分页层、数据层，典型结构如下：
# coding:utf-8
""" Compatible for python2.x and python3.x requirement: pip install requests """
from __future__ import print_function
import requests
# 配置参数 url=“o0b.cn/ibrad"
app_key = "YOUR_APP_KEY" q = "衣服" # 目标关键词
# 请求示例 url 默认请求参数已经做URL编码 url = "micro/item_search/?
key=<您自己的apiKey>&&q=女装&page=1&sort=&price_range=" headers = { "Accept-Encoding": "gzip", "Connection": "close" }
if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)
二、核心字段解析
1. 状态与分页字段（顶层）
字段名类型说明重要性
codeint状态码：0 = 成功，非 0 = 失败（如 401 = 权限不足）高
msgstring状态描述（失败时返回错误原因）中
data.totalint符合条件的商品总数（用于分页计算）高
data.page_noint当前页码（默认 1）中
data.page_sizeint每页商品数（默认 20，最大 100）中
2. 商品核心字段（items数组元素）
字段名类型说明业务价值
item_idstring商品唯一标识（微店系统内唯一）用于后续调用 “商品详情 API” 的关键参数
titlestring商品标题（含关键词，如 “夏季”“纯棉”）用于商品搜索、分类展示
pricestring销售价（保留 2 位小数，字符串类型）前端展示、价格对比
market_pricestring市场价（用于展示折扣，如 “原价 99，现价 59.9”）营销活动、折扣计算
stockint剩余库存（部分商品可能为 “-1” 表示无限库存）库存预警、售罄状态判断
salesint累计销量（部分 API 返回 30 天销量）热销商品排序、选品分析
statusint状态码：1 = 在售，2 = 下架，3 = 售罄前端过滤 “已下架” 商品，展示 “售罄” 标签
cover_imgstring封面图 URL（通常为正方形，尺寸 400×400）商品列表页展示图片
category_idstring所属分类 ID（关联店铺自定义分类）分类筛选、商品结构分析
created_atint创建时间戳（秒级）新品排序、上架时间统计
三、注意事项与扩展
字段兼容性：部分字段可能因 API 版本不同而变化（如sales在 v2 版本中可能返回month_sales），需参考官方文档确认。价格字段为字符串（避免浮点数精度问题），计算时需转换为float或Decimal类型。
分页处理：若商品总数total大于当前页数据量，需循环调用 API（递增page_no）获取全部数据，注意控制请求频率（建议每秒不超过 5 次）。
数据缓存：商品列表属于 “半静态数据”，建议缓存 30 分钟（用updated_at判断是否需要更新），减少 API 调用次数。
扩展字段：如需 SKU 信息（多规格商品），需调用 “商品详情 API”（vdian.item.get），传入item_id获取更详细的sku_list数组。
通过上述解析，可将 API 返回的原始数据转换为业务所需的结构化信息，支撑商品展示、库存管理、热销分析等核心功能。
