# Wildberries Scraper — Prices, Stock, Composition & Reviews (`blueskyscraper/wildberries-scraper`) Actor

Scrape Wildberries search results, product cards and reviews: RUB prices, discounts, stock, per-size variants, composition, category, pet attributes, price per kg and review texts, with change tracking between runs.

- **URL**: https://apify.com/blueskyscraper/wildberries-scraper.md
- **Developed by:** [BlueskyScraper](https://apify.com/blueskyscraper) (community)
- **Categories:** E-commerce, Automation, AI
- **Features:** Limited permissions
- **Stats:** 16 total users, 7 monthly users, 97.1% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.80 / 1,000 product cards

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does Wildberries Scraper do?

Wildberries Scraper collects **products, prices, stock and reviews from [Wildberries](https://www.wildberries.ru)** — Russia's largest marketplace — and adds what the listing pages don't show: **composition, category, animal, feed type, life stage, net weight and price per kg** from each product's public card.

It is built for **price monitoring, assortment tracking and trend research**: run it daily on the same keywords or product ids and every row tells you what changed since the previous run (`priceChange`, `stockChanged`, `ratingCountDelta`, `isNew`).

- 🔍 **Search** — products for any Russian keyword, in Wildberries' own order, with the position on the page
- 🗂️ **Categories** — the same product rows for Wildberries catalog pages (e.g. *Pet food & treats for dogs*), in the category's own order — discovery without guessing keywords
- 📦 **Product cards** — full rows for product ids or URLs: price, discount, stock, per-size variants, seller, rating
- ⭐ **Reviews** — newest reviews with rating, text, pros/cons, seller answer and date, **no buyer names**
- 📇 **Card details only** — composition, attributes, rating and the product's whole variant group (`groupNmIds`, star distribution per variant) for long id lists, fast and cheap without a browser; unknown ids come back as `not_found`
- 🧾 **Composition and pet attributes** for every product at no extra charge
- 🔁 **Change tracking** against an earlier dataset
- 🛡️ Unknown is never written as zero: missing values are `null` with a reason

### What data can I get from Wildberries?

| Field | Example |
|---|---|
| `nmId`, `imtId` | 559646349, 20790510 |
| `name`, `brand`, `seller`, `sellerId` | Сухой корм для собак…, Organix, PetshopRU |
| `price`, `originalPrice`, `discountPercent` (RUB) | 6030, 6853, 12 |
| `massGrams`, `pricePerKg` | 20000, 301.5 |
| `category`, `animal`, `feedType`, `lifeStage`, `animalSize` | Корм сухой, dog, dry, взрослые, для всех пород |
| `composition`, `purposeClaims`, `flavor`, `description` | Дегидрированное мясо индейки (22%)… |
| `rating`, `ratingCount` | 4.9, 244 |
| `stock` / `stockAtLeast`, `inStock`, `variants[]` | 17 / 40+, true |
| `position`, `query`, `deliveryHours`, `deliveryRegionDest` | 3, сухой корм для собак, 24 |
| `categoryUrl`, `categoryPath`, `categoryFilters`, `listingQuery` (Categories mode) | …/catalog/aksessuary/tovary-dlya-zhivotnyh/korm-dlya-zhivotnyh, Зоотовары / Для собак / Корм и лакомства, {"fbrand":"21830"} |
| `provenance` | run id, build, parser and schema version, observedAt, and `checksum` — `sha256:` + 64 hex characters, the SHA-256 of the JSON array of the row's observed values (product rows: ID, prices, rating, rating count, stock; review rows: review ID, rating, date) — it changes when any of them changes |
| `previousPrice`, `priceChange`, `stockChanged`, `isNew` | 6200, −170, false, false |

Review rows: `reviewId`, `nmId`, `rating`, `text`, `pros`, `cons`, `createdAt`, `hasPhoto`, `sellerAnswer`, `historyComplete`.

### How to scrape Wildberries

1. Pick **🧭 What to scrape**: Search, Categories, Product cards, Card details only or Reviews.
2. Enter keywords (`сухой корм для собак`), catalog links (`https://www.wildberries.ru/catalog/aksessuary/tovary-dlya-zhivotnyh/korm-dlya-zhivotnyh`) or product ids / URLs (`559646349`).
3. Set **💯 Max products** and, for search and categories, **📄 Pages per keyword or category** (about 100 products per page).
4. Optional: **⭐ Add reviews**, **📅 Only reviews since** for daily increments, **🔁 Previous dataset id** for change tracking, **🏷️ Snapshot / panel / query id** written into every row's provenance.
5. Run, then export to JSON, CSV or Excel, or call the Actor from the API.

```json
{
  "mode": "search",
  "searchQueries": ["сухой корм для собак", "сублимированный корм для собак"],
  "searchPages": 2,
  "maxItems": 300
}
```

```json
{
  "mode": "category",
  "categoryUrls": ["https://www.wildberries.ru/catalog/aksessuary/tovary-dlya-zhivotnyh/korm-dlya-zhivotnyh"],
  "searchPages": 3,
  "maxItems": 300
}
```

### How much does it cost to scrape Wildberries?

Pay per result, no subscription:

| Event | Price |
|---|---|
| Product from search or category results, or a Card details row | $0.0024 |
| Product card | $0.004 |
| Review | $0.0016 |
| Anti-bot browser session (once per run, only if the run returns data; not in the Details and Reviews modes) | $0.04 |

Higher Apify plans pay less per row (Bronze −10%, Silver −20%, Gold and above −30%). Error and notice rows are always free. Example: 300 search products ≈ $0.76.

### Large exports (10,000+ rows)

- Up to 10,000 rows per run. The run stops starting new work shortly before its timeout and writes one free notice row saying what was not reached — you never get a killed, half-written run.
- Progress is saved as the run goes: if Apify moves the run to another server, it continues where it stopped, without duplicate rows or double charges.
- **🗜️ Output format → Compact** drops the data-contract blocks (metrics, provenance) and long seller texts — several times smaller datasets.
- Search reads about 100 products per page with composition for each; expect about 200 products a minute (10,000 in roughly 50 minutes).

### Good to know

- **Stock is capped by Wildberries.** For well-stocked products the site shows a ceiling (around 40–45), so values of 40+ come as `stockAtLeast`, not as an exact `stock`. Stock and reviews are not sales — Wildberries does not publish sales (`sold` is always `null`).
- **Categories.** A category link is read the way the Wildberries site reads it: the catalog page loads its products through the same search service as keyword search, with the category's internal query from Wildberries' public catalog menu (written to `listingQuery`; a few curated menu collections use the older catalog service). Positions follow the category's own order on the page; `availableTotal` in `RUN_SUMMARY` is the category size Wildberries reports (up to 100 pages are read per category; Wildberries may stop serving pages earlier, and a repeated last page ends the category). Brand, price and other filters in the link are applied (`categoryFilters`); `sort=` in the link is used when **↕️ Sort order** is Popular. A link that is neither in the catalog menu nor opens a product list returns a free `category_not_resolved` row. Category rows have exactly the fields of search rows, plus the category fields; `query` is empty.
- **Per-query results.** A product found by two search queries appears under each, with its own `query` and `position`; reviews shared by variants of one product group are written (and billed) once.
- **Multipacks.** When the mass comes from the product name, `massGrams` is the whole pack: "24 шт по 85 г" → 2040 g, so `pricePerKg` is per kilogram of the pack. When the card itself lists several units per pack (`unitsInPack` > 1), its net weight may be per unit, so `pricePerKg` is null with `pricePerKgReason: multipack_mass_ambiguous`. `photosCount` is the number of photos on the card.
- **Input notes.** More than 20 search queries, or more product IDs than "Max products", are cut with a free notice row; in reviews mode the ID list is not cut. "Only reviews since" takes YYYY-MM-DD and counts from midnight Moscow time.
- **Two stock numbers.** `stock` is Wildberries' total over all warehouses (`stockScope: all_warehouses`); `variants[].stock` counts only the warehouses that deliver to the region in `deliveryRegionDest`, so it can be lower.
- **No ratings is not zero.** A product with `ratingCount: 0` has `rating: null` and `ratingAbsentReason: no_ratings`.
- **Reviews**: Wildberries serves roughly the latest 1,000 reviews of a product; `historyComplete` tells you whether that is the whole history. Reviews belong to the whole product group (`imtId`), and each row says which `nmId` it was written for. `excludedFromRating` is true only for reviews Wildberries itself left out of the product rating, with its reason codes in `excludedReasons` (e.g. `notProduct`).
- **Price per kg** is computed only when the net weight is unambiguous (see Multipacks above); otherwise `pricePerKg` is null with a `pricePerKgReason`.
- **Delivery region**: prices and `deliveryHours` are those Wildberries shows for the region in `deliveryRegionDest`.
- Composition, claims and attributes are the **seller's statements** as published, not verified facts.
- On the Apify Free plan a run returns up to 20 rows.

### FAQ

**Is it legal to scrape Wildberries?** The Actor reads only public pages and does not collect personal data (review authors are never stored). Check the site's terms and your local law for your use case.

**Can I monitor prices every day?** Yes — schedule the Actor and pass the previous run's dataset id in **🔁 Previous dataset id**; each row then carries the change since that snapshot.

**Something is missing?** Open an issue on the Actor page — we answer within a day.

Empty input fields don't start a demo run: an empty field returns a free row telling you what to fill in, and nothing is charged.

# Actor input Schema

## `mode` (type: `string`):

🔍 Search: product rows for keywords, in Wildberries' own order. 🗂️ Categories: the same rows for Wildberries catalog pages (category links), in the category's own order — discovery without keywords. 📦 Product cards: one full row per product id or URL, with price, stock and per-size variants. 📇 Card details only: composition, attributes, rating and the product's variant group for long id lists — fast and cheap, no browser, but no price or stock. ⭐ Reviews: review rows for product ids.

## `searchQueries` (type: `array`):

Keywords in Russian as a shopper types them, e.g. <code>сухой корм для собак</code> or <code>сублимированный корм</code>. Up to 20 keywords per run. Used by 🔍 Search.

## `categoryUrls` (type: `array`):

Wildberries catalog links, e.g. <code>https://www.wildberries.ru/catalog/aksessuary/tovary-dlya-zhivotnyh/korm-dlya-zhivotnyh</code> (Pet food & treats for dogs). Copy the link from the site's catalog menu. Filters in the link (brand <code>fbrand=</code>, price, etc.) are applied; <code>sort=</code> in the link is used when ↕️ Sort order is left at Popular. Up to 20 links per run. Used by 🗂️ Categories.

## `searchPages` (type: `integer`):

Wildberries shows about 100 products per page, for keywords and categories alike. The run stops earlier when results end (a repeated last page is detected) or 💯 Max products is reached.

## `sort` (type: `string`):

Order of search and category results, as on the site.

## `productIds` (type: `array`):

Wildberries article numbers (nmId), e.g. <code>559646349</code>, or product URLs like <code>https://www.wildberries.ru/catalog/559646349/detail.aspx</code>. Used by 📦 Product cards, 📇 Card details and ⭐ Reviews.

## `maxItems` (type: `integer`):

Upper limit of product rows for the whole run. Reviews are limited separately.

## `includeCardDetails` (type: `boolean`):

Adds composition, category, animal (dog/cat), feed type (dry/wet/treat), life stage, animal size, purpose claims, flavor, net weight and the seller's description from the product's public card. No extra charge.

## `includeRating` (type: `boolean`):

📇 Card details only: adds the rating, review count and the star distribution of every variant in the group (one extra request per product group).

## `includeReviews` (type: `boolean`):

After each product row, writes its newest reviews as separate review rows (charged per review).

## `maxReviews` (type: `integer`):

Newest first. Wildberries serves roughly the latest 1,000 reviews of a product; older history is not available from the site.

## `reviewsSince` (type: `string`):

Optional date (YYYY-MM-DD). Only reviews created on or after it are returned — use it for daily incremental collection.

## `outputFormat` (type: `string`):

Full: every row carries the data-contract blocks (metrics with units and absence reasons, provenance with run id, checksum and timestamps). Compact: the same data fields without those blocks and without long seller texts — several times smaller for exports of tens of thousands of rows.

## `snapshotId` (type: `string`):

Optional label of this snapshot (e.g. the date). Written into provenance of every row so snapshots can be compared.

## `panelId` (type: `string`):

Optional id of your fixed product panel (e.g. wb-dogfood-v3). Written into provenance of every row.

## `queryId` (type: `string`):

Optional id of your search profile version. Written into provenance of every row.

## `previousDatasetId` (type: `string`):

Dataset id of an earlier run. Each product then gets previousPrice, priceChange, stockChanged, ratingCountDelta and isNew against that snapshot. Pick the dataset of your earlier run of this Actor (or paste its ID) — the Actor gets read-only access to that one dataset. Left empty or unreadable, the run still returns all data, just without the change fields.

## `requestDelaySecs` (type: `integer`):

Pause between pages or products. Raise it if the site starts refusing requests.

## Actor input object example

```json
{
  "mode": "search",
  "searchQueries": [
    "корм для собак"
  ],
  "categoryUrls": [
    "https://www.wildberries.ru/catalog/aksessuary/tovary-dlya-zhivotnyh/korm-dlya-zhivotnyh"
  ],
  "searchPages": 1,
  "sort": "popular",
  "productIds": [
    "559646349"
  ],
  "maxItems": 100,
  "includeCardDetails": true,
  "includeRating": true,
  "includeReviews": false,
  "maxReviews": 20,
  "outputFormat": "full",
  "requestDelaySecs": 1
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "корм для собак"
    ],
    "categoryUrls": [
        "https://www.wildberries.ru/catalog/aksessuary/tovary-dlya-zhivotnyh/korm-dlya-zhivotnyh"
    ],
    "productIds": [
        "559646349"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("blueskyscraper/wildberries-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": ["корм для собак"],
    "categoryUrls": ["https://www.wildberries.ru/catalog/aksessuary/tovary-dlya-zhivotnyh/korm-dlya-zhivotnyh"],
    "productIds": ["559646349"],
}

# Run the Actor and wait for it to finish
run = client.actor("blueskyscraper/wildberries-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "корм для собак"
  ],
  "categoryUrls": [
    "https://www.wildberries.ru/catalog/aksessuary/tovary-dlya-zhivotnyh/korm-dlya-zhivotnyh"
  ],
  "productIds": [
    "559646349"
  ]
}' |
apify call blueskyscraper/wildberries-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,blueskyscraper/wildberries-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/irowGQJHZLYfbZoqG/builds/7MKxkm2jhJ6tX0MFZ/openapi.json
