方法
获取商品价格历史
某个商品价格与库存观测记录的完整时间序列——与当前价格不同（当前价格已包含在 GET /products 和 GET /products/{id} 中），这个端点仅在需要分析历史趋势时才用到。
Authorization
bearerAuth AuthorizationBearer <token>
Bearer 令牌——获取方式与使用方法请参阅 API 概览。
In: header
Path Parameters
id*string
Format
uuidQuery Parameters
country_code?string
限定某一个国家市场版本（例如市场平台的国家域名代码，如 Wildberries 的 ru/kz/by/am）。不区分大小写匹配。
region_code?string
限定某一个具体地区或仓库（该代码是市场平台自有的，不做跨平台统一）。
user_auth_status?string
按所显示的价格是访客价格还是登录用户价格进行筛选。
Value in
- "anonymous"
- "authenticated"
from?string
时间范围起点（ISO 8601）。不能晚于 to。
Format
date-timeto?string
时间范围终点（ISO 8601）。
Format
date-timepage?integer
无效或缺失的值会被静默限制为默认值，而不会以 400 错误拒绝。
Range
1 <= valueDefault
1page_size?integer
最大值为 500——相比典型的面向 UI 的 API，这个值刻意设置得更宽松，专为批量拉取场景设计。
Range
1 <= value <= 500Default
100Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/products/e86bee19-9cc9-4a83-b9cc-6b61f1209d90/price-history?from=2026-08-01T00%3A00%3A00Z&to=2026-08-02T00%3A00%3A00Z"{ "data": [ { "country_code": "ru", "region_code": null, "user_auth_status": "anonymous", "price": 7093, "old_price": 8651, "currency": "RUB", "stock_status": null, "stock_quantity": null, "recorded_at": "2026-08-02T23:21:53.185302+00:00" }, { "country_code": "ru", "region_code": null, "user_auth_status": "anonymous", "price": 6993, "old_price": 8688, "currency": "RUB", "stock_status": null, "stock_quantity": null, "recorded_at": "2026-08-01T01:03:17.999423+00:00" } ], "meta": { "total": 2, "page": 1, "page_size": 100 }}