Market NinjaMarket Ninja

История цен товара

GET
/products/{id}/price-history

Полная временная серия наблюдений цены и остатков по товару — в отличие от текущей цены (уже включена в ответ GET /products и GET /products/{id}), этот эндпоинт нужен только для анализа исторической динамики.

Authorization

bearerAuth
AuthorizationBearer <token>

Bearer-токен — как получить и использовать, см. Обзор API.

In: header

Path Parameters

id*string
Formatuuid

Query Parameters

country_code?string

Фильтр по конкретному страновому варианту (например, доменный код маркетплейса — ru/kz/by/am у Wildberries). Регистр не учитывается.

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

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