获取商品价格历史

某个商品价格与库存观测记录的完整时间序列——与当前价格不同（当前价格已包含在 GET /products 和 GET /products/{id} 中），这个端点仅在需要分析历史趋势时才用到。

Authorization

bearerAuth

AuthorizationBearer <token>

Bearer 令牌——获取和使用方法请参阅文档中的「API 概览」页面。

In: header

Path Parameters

id*string

Formatuuid

Query 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。

Formatdate-time

to?string

时间范围终点（ISO 8601）。

Formatdate-time

page?integer

无效或缺失的值会被静默限制为默认值，而不会以 400 错误拒绝。

Range1 <= value

Default1

page_size?integer

最大值为 500——相比典型的面向 UI 的 API，这个值刻意设置得更宽松，专为批量拉取场景设计。

Range1 <= value <= 500

Default100

Response Body

`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  }}

获取商品价格历史

Authorization

Path Parameters

Query Parameters

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`