MPSTATS

MPSTATS

This connector uses the MPSTATS Analytics API (https://mpstats.io/api/analytics/v1): market analytics for Wildberries (/wb) and Ozon (/oz) collected by MPSTATS. It reads public marketplace data for any item, subject or niche, category, brand or seller, yours or a competitor's: sales, estimated revenue, prices, stock per warehouse and size, search queries and positions. Every tool only reads; nothing on the marketplaces is changed. It does not reach your own seller cabinet: for orders and finance use the Wildberries or Ozon connector.

Setup (about 2 minutes)

1. Sign in at https://mpstats.io with an account whose plan includes API requests, open the account settings and copy the token from the API token block into MPSTATS_API_TOKEN.
2. Install and run mpstats_wb_get_keyword_frequency to check the token.

The token is sent in the X-Mpstats-TOKEN header. It changes when the account password is changed or Change API token is pressed; paste the new one then.

Cost and limits: every call counts against the request quota of your MPSTATS plan. 429 means the quota is used up (the message says why, Retry-After says when to retry); 202 means MPSTATS is still preparing the report, so call again a little later. Keep periods short and pages small, and reuse what you already fetched instead of calling again.

Wildberries workflow

• Resolve names first: mpstats_wb_find_items (SKUs or keyword), mpstats_wb_search_subjects, mpstats_wb_search_sellers, mpstats_wb_search_brands.
• One item: mpstats_wb_get_item, mpstats_wb_get_item_sales (per day: sales, revenue, stock, price, category position), mpstats_wb_get_item_search_stats, mpstats_wb_list_item_keywords (queries and positions), mpstats_wb_get_item_stock_by_warehouse, mpstats_wb_get_item_stock_by_size, mpstats_wb_get_item_sales_by_warehouse, mpstats_wb_get_item_sales_by_size.
• Competitors of an item: mpstats_wb_list_related_items (relation similar, in_similar, identical_wb or identical).
• Niche analysis: mpstats_wb_list_subject_items, mpstats_wb_list_subject_breakdown (categories, brands, sellers), mpstats_wb_get_subject_trend (seasonality).
• Category analysis: mpstats_wb_list_category_items, mpstats_wb_list_category_breakdown (subcategories, subjects, brands, sellers), mpstats_wb_get_category_trend.
• A shop or brand: mpstats_wb_list_seller_items, mpstats_wb_list_brand_items. Search demand: mpstats_wb_get_keyword_frequency.

Ozon workflow: mpstats_oz_find_items, mpstats_oz_get_item, mpstats_oz_get_item_sales, mpstats_oz_list_item_keywords, mpstats_oz_get_item_category_positions, mpstats_oz_get_item_stock_by_warehouse (one day), mpstats_oz_get_item_sales_by_warehouse, mpstats_oz_list_similar_items; niches with mpstats_oz_search_niches and mpstats_oz_list_niche_items; categories with mpstats_oz_list_category_items, mpstats_oz_list_category_breakdown (subcategories, niches, brands, sellers) and mpstats_oz_get_category_trend; shops and brands with mpstats_oz_search_sellers, mpstats_oz_list_seller_items and mpstats_oz_list_brand_items.

Identifiers: items are marketplace SKUs (the Wildberries article number nmId, the Ozon SKU). Wildberries subjects and Ozon niches and sellers use numeric ids from the search tools; categories are full paths with /, exactly as MPSTATS shows them (e.g. Женщинам/Джинсы); brands are names.

Periods and figures: d1 and d2 are YYYY-MM-DD; always pass them, the default period differs from method to method. Data runs to yesterday. Sales and revenue are MPSTATS estimates from public marketplace data, in roubles; quote them as estimates, not as the seller's accounting. fbs=1 adds sales shipped from the seller's own warehouse (FBS), 0 counts marketplace warehouses (FBO) only.

Paging, sorting and filters: list tools return startRow, endRow, total and data. At most 500 rows per call: raise startRow/endRow to page. sortModel sorts, e.g. [{"colId": "revenue", "sort": "desc"}]; filterModel filters columns, e.g. {"revenue": {"filterType": "number", "type": "greaterThan", "filter": 100000}} (text filters: equals, contains, startsWith...; number and date filters: lessThan, greaterThan, inRange with filterTo).

Errors: 401 means a wrong or changed token. 429 means the plan's request quota is used up. 202 means the report is not ready yet. 500 carries the reason in message.