Market NinjaMarket Ninja
Endpoints

Get product price history

GET
/products/{id}/price-history

The full time series of price and stock observations for a product — unlike the current price (already included in GET /products and GET /products/{id}), this endpoint is only needed for historical trend analysis.

Authorization

bearerAuth
AuthorizationBearer <token>

Bearer token — see API Overview for how to get one and use it.

In: header

Path Parameters

id*string
Formatuuid

Query Parameters

country_code?string

Filter to one specific country-market variant (e.g. a marketplace's country-domain code, such as Wildberries' ru/kz/by/am). Matched case-insensitively.

region_code?string

Filter to one specific region or warehouse (code is marketplace-native, not unified).

user_auth_status?string

Filter by whether the price shown was for a guest or a logged-in shopper.

Value in

  • "anonymous"
  • "authenticated"
from?string

Start of the range (ISO 8601). Must not be after to.

Formatdate-time
to?string

End of the range (ISO 8601).

Formatdate-time
page?integer

Invalid or missing values are silently clamped to the default rather than rejected with a 400.

Range1 <= value
Default1
page_size?integer

500 max — deliberately generous relative to a typical UI-facing API, sized for bulk pulls.

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

Get a product by ID GET

`id` is our own internal identifier (a UUID), not a marketplace SKU. The only way to obtain it is via `GET /products` (by `url`, `external_id`+`marketplace`, or `seller_code`) — nothing external ever knows it up front.

List products GET

Returns one page of products matching the given filters. No single filter is required, but you should almost always pass at least one identifying parameter (`url`, `external_id`+`marketplace`, or `seller_code`) — otherwise you get a broad slice of the whole dataset.