# Wildberries Niche Analyzer · Анализ ниши Wildberries (`theshark/wildberries-niche-analyzer`) Actor

Size up a Wildberries niche by keyword, category, shop or brand: brands and sellers with shares, concentration, prices, ratings, reviews. Анализ ниши Wildberries по запросу, категории, магазину или бренду: бренды и продавцы с долями, концентрация, цены, рейтинги, отзывы.

- **URL**: https://apify.com/theshark/wildberries-niche-analyzer.md
- **Developed by:** [TheShark](https://apify.com/theshark) (community)
- **Categories:** E-commerce, Marketing
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.40 / 1,000 niche summary · сводка ниши

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## Wildberries Niche Analyzer · Анализ ниши Wildberries

Size up a **Wildberries niche** before you enter it. For every keyword or category you give, the Actor reads the first search pages
— the products buyers see first — and returns **one summary row**: how many products and sellers the niche has, which brands and
sellers lead it and with what share, how concentrated it is, the prices to pay, ratings, reviews and discounts. A competitor's shop
or a brand can be analyzed the same way, and every run shows what changed since the previous one.

*Описание на русском — ниже, в разделе «По-русски».*

### What you get

- **Size**: `total_products` (in the whole results, by the site's count), `sellers_total` (different sellers in the whole
  results), `pages_analyzed`, `products_analyzed`.
- **Competition**: `brands_count`, `sellers_count`, `products_without_brand`, `top_brands` and `top_sellers` (up to 10 each, with
  products and share), `brand_hhi` and `seller_hhi` — the Herfindahl–Hirschman index from 0 to 10,000.
- **Prices to pay**: `price_min`, `price_median`, `price_avg`, `price_max`, rubles.
- **Demand signals**: `rating_avg`, `reviews_total`, `reviews_median`, `with_reviews_percent`.
- **Offers**: `in_stock_percent`, `with_discount_percent`, `discount_median`.
- **Change since the last run**: `total_products_change`, `sellers_total_change`, `price_median_change`, the previous values and
  `previous_checked_at`.
- **A status in every row**: `ok`, `no_results`, `not_found`, `partial`, `skipped`, `error`.

### Why this Actor

- **One row per niche** — ready to compare many keywords in one table.
- **Real prices.** The summary uses the price to pay that the site shows in your delivery region.
- **The whole niche where the site tells it**: the total number of products and of sellers comes for the whole results, not only
  for the analyzed pages.
- **Categories too.** A category link is analyzed as the site's own search for that category.
- **A shop or a brand.** A seller's shop (`/seller/12345`) or a brand (`/brands/...`) is analyzed by its own product list: what a
  competitor sells, which brands, at what prices and with what reviews.
- **Trend.** Schedule the Actor: every niche is compared with the previous run — products, sellers and the median price.
- **Pay only for summaries.** Empty results, unknown categories, incomplete summaries and errors are free.

### How to use

1. Put **search words** (one niche each) or **links** to a category, a shop or a brand into the input.
2. Set **Search pages per niche** — 1 to 3 pages of 100 products; 3 by default.
3. Pick the delivery region and run it. One row per niche appears in the dataset; the **Niches** view shows them as a table.
4. For a trend, schedule the Actor with the same **History store**.

### Examples

Input:

```json
{
  "queries": ["термос", "блузка женская"],
  "urls": ["https://www.wildberries.ru/catalog/zhenshchinam/odezhda/bluzki-i-rubashki"],
  "depth_pages": 3,
  "region": "moscow"
}
```

A row from a test run (shortened: the top lists keep 2 of 10):

```json
{
  "status": "ok",
  "query": "термос",
  "total_products": 116792,
  "pages_analyzed": 3,
  "products_analyzed": 300,
  "sellers_total": 8736,
  "brands_count": 93,
  "sellers_count": 120,
  "products_without_brand": 71,
  "top_brands": [
    {"brand": "Gianxi", "brand_id": 312202076, "products": 12, "share_percent": 5.2},
    {"brand": "IntermoS", "brand_id": 249033, "products": 9, "share_percent": 3.9}
  ],
  "top_sellers": [
    {"seller_id": 250085749, "url": "https://www.wildberries.ru/seller/250085749", "products": 17, "share_percent": 5.7},
    {"seller_id": 4123, "url": "https://www.wildberries.ru/seller/4123", "products": 14, "share_percent": 4.7}
  ],
  "brand_hhi": 191,
  "seller_hhi": 175,
  "price_min": 301.0,
  "price_median": 1226.0,
  "price_avg": 1393.68,
  "price_max": 7375.0,
  "rating_avg": 4.76,
  "reviews_total": 299899,
  "reviews_median": 187.5,
  "with_reviews_percent": 94.0,
  "in_stock_percent": 100.0,
  "with_discount_percent": 100.0
}
```

### Pricing

| Event | Price | What it is |
|---|---|---|
| `niche` | $0.0034 ($3.40 per 1,000) | a niche summary with `ok` |
| Actor start | $0.00425 | once per run at the default 1 GB of memory (Apify counts one more start for every GB above) |

`no_results`, `not_found`, `partial`, `skipped` and `error` rows are free. A run never charges more than its maximum total charge.
The **Pricing** tab always shows the current prices.

### Good to know

- **Shares and the index are by the number of products.** Wildberries does not show sales to visitors, so `share_percent`,
  `brand_hhi` and `seller_hhi` count products on the analyzed pages, not money. A brand's share is among products with a brand.
- **Why the first pages.** The site gives no counts per brand or seller for the whole results, so the summary covers the first up
  to 300 products — the part of the niche buyers actually see.
- **In stock and discount are almost always 100%.** Search shows products on sale, and the site shows a discount on nearly every
  product; `discount_median` tells how deep the discounts are.
- `partial` — not every page came: the row keeps what was analyzed and is free.
- A category link is searched by the category's own query from the site menu; filters in the link are not applied.
- **A shop or a brand has no `sellers_total`.** The site gives no full seller list for them: a brand's filter shows at most 8
  sellers (in our check a brand had 23 sellers on one search page and 8 in its filter), and a shop is one seller.
- **The history store** keeps per niche only the product count, the seller count, the median price, the number of analyzed pages
  and the date; a niche not checked for 90 days is forgotten. Incomplete summaries and errors do not overwrite the previous record.
- **The median price change** is given only when both runs analyzed the same number of pages: a median over 100 products and one
  over 300 are not comparable.
- **Speed.** At the default 1 GB of memory, a niche takes about 11–14 s once the browser has started; a run of one niche takes
  about half a minute on Apify.
- **No charge for failures.** If the run gets no data, it ends with an error instead of empty rows; those niches are free.
- **Browser cache.** To start faster and spend less traffic, the run keeps the site's own scripts that its browser downloaded in a
  named store in your account, `wildberries-browser-cache-niche`: no cookies, tokens or passwords. Delete it any time — the next run just starts slower.
- The Actor is not connected with Wildberries; it reads only what the site shows to any visitor.

### What is not in the data

- **No seller names**: a seller can be an individual entrepreneur, that is a person, so `top_sellers` has only the seller ID, the
  shop link, the number of products and the share.
- No buyer data: only counts of reviews and ratings.
- The history store holds numbers and dates only: no cookies and no proxies.

### Our other Actors

Wildberries:

- [Wildberries Scraper](https://apify.com/theshark/wildberries-scraper) — products by article, link, search or category: price to pay, stock, sizes, details.
- [Wildberries Reviews Scraper](https://apify.com/theshark/wildberries-reviews-scraper) — reviews and questions of products, only new ones if you like.
- [Wildberries Price Monitor](https://apify.com/theshark/wildberries-price-monitor) — prices and stock of your articles and what changed since the last run.
- [Wildberries Seller Scraper](https://apify.com/theshark/wildberries-seller-scraper) — seller profiles: items sold, rating, reviews; for companies also name, INN, OGRN.
- [Wildberries Position Tracker](https://apify.com/theshark/wildberries-search-position-tracker) — where your products rank for every keyword, and the top of a keyword.
- [Wildberries Keyword Scraper](https://apify.com/theshark/wildberries-keyword-scraper) — search box suggestions and related searches for your seed words.

Other marketplaces:

- [Ozon Scraper](https://apify.com/theshark/ozon-scraper) — Ozon products from search, links and categories, with price history.
- [Ozon Reviews Scraper](https://apify.com/theshark/ozon-reviews-scraper) — Ozon reviews and questions, only new ones if you like.
- [Ozon Seller Scraper](https://apify.com/theshark/ozon-seller-scraper) — Ozon seller profiles: company name, OGRN, rating, orders.
- [Ozon Buy Box Scraper](https://apify.com/theshark/ozon-buybox-scraper) — every seller of an Ozon product with price and delivery.
- [Yandex Market Scraper](https://apify.com/theshark/yandex-market-scraper) — Yandex Market products: price with and without the card, stock, seller.
- [Yandex Market Reviews Scraper](https://apify.com/theshark/yandex-market-reviews-scraper) — Yandex Market reviews: score, text, pros, cons, seller reply.

***

### По-русски

**Анализ ниши Wildberries** перед входом в неё. По каждому запросу или категории актор читает первые страницы поиска — товары,
которые покупатель видит первыми, — и даёт **одну строку сводки**: сколько в нише товаров и продавцов, какие бренды и продавцы её
ведут и с какой долей, насколько она сосредоточена, цены к оплате, рейтинги, отзывы и скидки. Так же можно разобрать магазин
конкурента или бренд, а каждый запуск показывает, что изменилось с прошлого.

#### Что в строке

- **Размер**: `total_products` (во всей выдаче, по счёту сайта), `sellers_total` (разных продавцов во всей выдаче),
  `pages_analyzed`, `products_analyzed`.
- **Конкуренция**: `brands_count`, `sellers_count`, `products_without_brand`, `top_brands` и `top_sellers` (до 10, с числом
  товаров и долей), `brand_hhi` и `seller_hhi` — индекс Херфиндаля — Хиршмана от 0 до 10 000.
- **Цены к оплате**: `price_min`, `price_median`, `price_avg`, `price_max`, рубли.
- **Признаки спроса**: `rating_avg`, `reviews_total`, `reviews_median`, `with_reviews_percent`.
- **Предложения**: `in_stock_percent`, `with_discount_percent`, `discount_median`.
- **Изменение с прошлого запуска**: `total_products_change`, `sellers_total_change`, `price_median_change`, прошлые значения и
  `previous_checked_at`.
- **Статус в каждой строке**: `ok`, `no_results`, `not_found`, `partial`, `skipped`, `error`.

#### Почему этот актор

- **Одна строка на нишу** — много запросов легко сравнить в одной таблице.
- **Настоящие цены.** Сводка считает цену к оплате, которую сайт показывает в вашем регионе доставки.
- **Вся ниша там, где сайт это говорит**: число товаров и продавцов — по всей выдаче, а не только по разобранным страницам.
- **И категории.** Ссылка на категорию разбирается как собственный поиск сайта по этой категории.
- **Магазин или бренд.** Магазин продавца (`/seller/12345`) или бренд (`/brands/...`) разбирается по собственному списку его
  товаров: что продаёт конкурент, какие бренды, почём и с какими отзывами.
- **Динамика.** Поставьте актор в расписание: каждая ниша сравнивается с прошлым запуском — товары, продавцы и медиана цены.
- **Платите только за сводки.** Пустая выдача, неизвестная категория, неполная сводка и ошибки бесплатны.

#### Как запустить

1. Укажите **слова поиска** (каждое — своя ниша) или **ссылки** на категорию, магазин или бренд.
2. Задайте **Страниц выдачи на нишу** — от 1 до 3 страниц по 100 товаров; по умолчанию 3.
3. Выберите регион доставки и запустите. В датасете — строка на нишу; вид **Niches** показывает их таблицей.
4. Для динамики поставьте актор в расписание, а **Хранилище истории** оставьте тем же.

#### Примеры

Пример входа и строки — выше, в английской части: поля одни и те же. Строка — из нашего проверочного запуска.

#### Цена

| Событие | Цена | За что |
|---|---|---|
| `niche` | $0,0034 ($3,40 за 1000) | сводка ниши со статусом `ok` |
| Запуск | $0,00425 | раз на запуск при памяти по умолчанию 1 ГБ (Apify считает ещё один запуск за каждый ГБ сверх) |

Строки `no_results`, `not_found`, `partial`, `skipped` и `error` бесплатны. Запуск не спишет больше своего лимита трат. Точные
текущие цены — на вкладке **Pricing**.

#### Что важно знать

- **Доли и индекс — по числу товаров.** Продаж Wildberries посетителю не показывает, поэтому `share_percent`, `brand_hhi` и
  `seller_hhi` считают товары на разобранных страницах, а не деньги. Доля бренда — среди товаров с брендом.
- **Почему первые страницы.** Числа по брендам и продавцам для всей выдачи сайт не даёт, поэтому сводка — по первым до 300 товарам:
  той части ниши, которую покупатель правда видит.
- **В наличии и со скидкой — почти всегда 100 %.** Поиск показывает товары в продаже, а скидку сайт ставит почти всем;
  `discount_median` говорит, насколько скидки глубокие.
- `partial` — пришли не все страницы: в строке то, что успели разобрать, и она бесплатна.
- Ссылка на категорию ищется по собственному запросу категории из меню сайта; фильтры из ссылки не применяются.
- **У магазина и бренда нет `sellers_total`.** Полного списка продавцов для них сайт не даёт: фильтр бренда показывает не больше 8
  продавцов (в нашей проверке у бренда на одной странице поиска было 23 продавца, а в его фильтре — 8), а магазин — это один продавец.
- **Хранилище истории** держит у ниши только число товаров, продавцов, медиану цены, число разобранных страниц и дату; ниша, которую
  90 дней не проверяли, забывается. Неполные сводки и ошибки прошлую запись не затирают.
- **Изменение медианы цены** есть, только если оба запуска разобрали одно и то же число страниц: медиана по 100 товарам и по 300
  несравнимы.
- **Скорость.** При памяти по умолчанию 1 ГБ ниша занимает около 11–14 с после запуска браузера; запуск на одну нишу на Apify —
  около полминуты.
- **Сбой не оплачивается.** Если данных получить не удалось, запуск кончается ошибкой, а не пустыми строками; такие ниши бесплатны.
- **Кеш браузера.** Чтобы запуск начинался быстрее и тратил меньше трафика, скрипты сайта, которые скачал браузер, лежат в именованном
  хранилище в вашем аккаунте — `wildberries-browser-cache-niche`: без cookies, токенов и паролей. Его можно удалить в любой момент: следующий запуск просто
  начнётся медленнее.
- Актор не связан с Wildberries и читает только то, что сайт показывает любому посетителю.

#### Чего нет в данных

- **Имён продавцов нет**: продавец бывает ИП, то есть человеком, поэтому в `top_sellers` — только номер продавца, ссылка на
  магазин, число товаров и доля.
- Данных покупателей нет: только число отзывов и оценки.
- В хранилище истории — только числа и даты: ни cookies, ни прокси.

#### Другие наши акторы

Wildberries:

- [Парсер Wildberries](https://apify.com/theshark/wildberries-scraper) — товары по артикулу, ссылке, поиску или категории: цена к оплате, остаток, размеры, характеристики.
- [Парсер отзывов Wildberries](https://apify.com/theshark/wildberries-reviews-scraper) — отзывы и вопросы о товарах, можно только новые.
- [Мониторинг цен Wildberries](https://apify.com/theshark/wildberries-price-monitor) — цены и наличие ваших артикулов и что изменилось с прошлого запуска.
- [Парсер продавцов Wildberries](https://apify.com/theshark/wildberries-seller-scraper) — профили продавцов: продано за всё время, рейтинг, отзывы; у компаний — ещё название, ИНН, ОГРН.
- [Позиции товаров Wildberries](https://apify.com/theshark/wildberries-search-position-tracker) — места ваших товаров по каждому запросу и топ запроса.
- [Ключевые слова Wildberries](https://apify.com/theshark/wildberries-keyword-scraper) — подсказки строки поиска и связанные запросы к вашим словам.

Другие площадки:

- [Парсер Ozon](https://apify.com/theshark/ozon-scraper) — товары Ozon из поиска, ссылок и категорий, с историей цен.
- [Парсер отзывов Ozon](https://apify.com/theshark/ozon-reviews-scraper) — отзывы и вопросы о товарах Ozon, можно только новые.
- [Парсер продавцов Ozon](https://apify.com/theshark/ozon-seller-scraper) — профили продавцов Ozon: юрлицо, ОГРН, рейтинг, заказы.
- [Все продавцы товара Ozon](https://apify.com/theshark/ozon-buybox-scraper) — все продавцы товара с ценой и доставкой.
- [Парсер Яндекс Маркета](https://apify.com/theshark/yandex-market-scraper) — товары Яндекс Маркета: цена с картой и без, остаток, продавец.
- [Отзывы Яндекс Маркета](https://apify.com/theshark/yandex-market-reviews-scraper) — отзывы о товарах: оценка, текст, плюсы, минусы, ответ продавца.

# Actor input Schema

## `queries` (type: `array`):

Keywords as a buyer types them on the site. Every keyword is one niche and one row.<br><br>Слова, как их набирает покупатель на сайте. Каждое слово — одна ниша и одна строка.

## `urls` (type: `array`):

Links on wildberries.ru to a category (/catalog/...), a search, a seller's shop with the seller ID (/seller/12345) or a brand (/brands/...). A category is analyzed as the site's own search for it; a shop or a brand — by its own product list, to size up a competitor. Filters in the link are not applied.<br><br>Ссылки на wildberries.ru: на категорию (/catalog/...), поиск, магазин продавца с номером (/seller/12345) или бренд (/brands/...). Категория разбирается как собственный поиск сайта по ней; магазин или бренд — по их собственному списку товаров, чтобы оценить конкурента. Фильтры из ссылки не применяются.

## `depth_pages` (type: `integer`):

How many first pages of the results to analyze, 100 products each. The summary is over these products; the total product count and the number of sellers are for the whole results.<br><br>Сколько первых страниц выдачи разбирать, по 100 товаров. Сводка — по этим товарам; общее число товаров и продавцов — по всей выдаче.

## `region` (type: `string`):

Search results, prices and stock depend on the delivery region.<br><br>Выдача, цены и наличие зависят от региона доставки.

## `dest` (type: `integer`):

Optional. The site's dest code for another delivery zone; replaces the region above.<br><br>Необязательно. Код dest сайта для другой зоны доставки; заменяет регион выше.

## `history_store` (type: `string`):

Named key-value store in your account with the summaries of earlier runs: the run compares every niche with the last run that used the same store. It keeps only the product count, the seller count, the median price, the number of analyzed pages and the date. A niche not checked for 90 days is forgotten.<br><br>Именованное хранилище в вашем аккаунте со сводками прошлых запусков: запуск сравнивает каждую нишу с прошлым запуском с тем же хранилищем. Там только число товаров, продавцов, медиана цены, число разобранных страниц и дата. Ниша, которую 90 дней не проверяли, забывается.

## `proxy` (type: `string`):

Optional. One per line: user:pass@host:port. Without them the run uses its own Russian proxies.<br><br>Необязательно. По одному в строке: user:pass@host:port. Без них запуск идёт через свои российские прокси.

## `output_language` (type: `string`):

Wildberries's own data stays as the site gives it.<br><br>Данные Wildberries остаются такими, как их отдаёт сайт.

## Actor input object example

```json
{
  "queries": [
    "thermos"
  ],
  "urls": [],
  "depth_pages": 3,
  "region": "moscow",
  "history_store": "wildberries-niche-history",
  "output_language": "en"
}
```

# Actor output Schema

## `results` (type: `string`):

One row per niche: keyword, category, shop or brand. Строка на нишу: запрос, категорию, магазин или бренд.

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

OUTPUT record: rows and their statuses, traffic and the reason of a failure. Запись OUTPUT: строки и их статусы, трафик и причина сбоя.

# 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 = {
    "queries": [
        "thermos"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("theshark/wildberries-niche-analyzer").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 = { "queries": ["thermos"] }

# Run the Actor and wait for it to finish
run = client.actor("theshark/wildberries-niche-analyzer").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 '{
  "queries": [
    "thermos"
  ]
}' |
apify call theshark/wildberries-niche-analyzer --silent --output-dataset

```

## MCP server setup

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

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/9MWapOM6Lclnzvkdo/builds/zkHy8H4fD2ehtIaFN/openapi.json
