Skip to content

Release notes

Changes to the Marketplace Analytics API and dashboard, newest first. Dates are release dates.

The format follows Keep a Changelog, and version numbers follow semantic versioning: a breaking change to a response shape or an endpoint path increments the major version.

Unreleased

Work that is on the roadmap but not yet shipped. Nothing here is available in a released version.

Planned

  • Authentication on the API, so the service can be exposed without relying entirely on a reverse proxy for access control.
  • Configurable installation path, removing the hard-coded /opt/analytics in the on-demand sync.
  • A persisted import history, so that a restart no longer discards the record of what was synced and when.
  • A configurable window for the seasonality endpoint, which is currently fixed at 90 days.

1.0.0

Released 20 May 2026

First public release. Consolidates Wildberries and Ozon seller data into one database and exposes it through a REST API and a dashboard.

Added

Data import. Scheduled daily sync at 06:00 pulling sales, orders, stock levels and listing statistics from the official Wildberries and Ozon APIs. Manual import through run_etl.py with per-marketplace and date-range options, and on-demand import from the dashboard.

Profit reporting. Revenue, net revenue and gross profit at daily, weekly, monthly and quarterly granularity, per marketplace. Gross profit accounts for marketplace commission, logistics and your own cost price.

Product economics. Per-SKU profitability with ROI, ABC classification by cumulative profit share, and best and worst performer rankings by profit, revenue or units.

Inventory. Stock levels per product with days of cover projected from the recent sales rate, and an urgency status that reflects that rate rather than a fixed quantity threshold.

Listing analytics. Daily impression, click, cart and order statistics per listing, and a conversion funnel with rates calculated at each step.

Comparisons. Week-on-week trends, period-against-preceding-period comparison, a marketplace comparison expressing commission and logistics as a share of revenue, and a weekday seasonality breakdown.

Exports. CSV export for finance, profitability, reorder, listing and platform data. Files are UTF-8 with a byte order mark so that Cyrillic opens correctly in Excel.

Alerts. Optional Telegram message at 09:00 listing products at risk of running out.

Deployment. Single-command installation on Ubuntu 22.04, covering PostgreSQL, the systemd service, the Nginx reverse proxy and both cron jobs.

Known issues

  • The API has no authentication and accepts cross-origin requests from any origin. It must run behind a reverse proxy that restricts access.
  • FastAPI's generated /docs and /redoc endpoints are disabled. This documentation set is the API reference.
  • On-demand sync uses absolute paths under /opt/analytics and fails on installations elsewhere. Scheduled cron syncs are unaffected.
  • On-demand sync is abandoned after 15 minutes. Long historical imports must be run from the command line.
  • Sync state is held in memory and is lost when the service restarts.
  • The seasonality endpoint's 90-day window is fixed and ignores the dashboard's period selector.
  • Relative date windows use the server's local time rather than UTC.
  • Profit figures treat a product with no cost price as costing nothing, and are therefore overstated until cost prices are entered.