# Wildberries Position Tracker · Позиции товаров Wildberries (`theshark/wildberries-search-position-tracker`) Actor

Where your Wildberries products rank in search: for every keyword and article, the place in the first 1000 results and its change. Где ваши товары в поиске Wildberries: место каждого артикула по каждому запросу в первых 1000 результатах и сдвиг с прошлого запуска.

- **URL**: https://apify.com/theshark/wildberries-search-position-tracker.md
- **Developed by:** [TheShark](https://apify.com/theshark) (community)
- **Categories:** E-commerce, SEO tools, 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 position check · проверка позиции

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 Position Tracker · Позиции товаров Wildberries

Find **where your Wildberries products stand in search**. For every keyword and every article number you give, the Actor returns
the **place in the site's order** within the first 1,000 results, the place at your previous run and how many places the product
moved. Track your own products or your competitors' — schedule it daily and see the trend. Or track the **whole top of a
keyword**: who entered the first places, who moved and who dropped out since the last run.

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

### What you get

- **A row per keyword and product**: `query`, `article`, `found`, `position` (from 1), `checked_positions`, `total_results`
  (products for the keyword), `url`.
- **The change**: `previous_position`, `previous_checked_at`, `position_change` (plus — up, minus — down).
- **The found product** as the search shows it: `name`, `brand`, `price` (to pay, rubles).
- **Top tracking** (**Top places to track**): a row per product in the first places of every keyword, with `top_change` — `new`
  (entered the top), `up`, `down`, `same` — and a row for every product that was in the top last time and is not now (`left`).
- **A status in every row**: `ok` (checked, found or not), `skipped`, `error`.

### Why this Actor

- **The site's real order.** Places are counted in the same order as the search answer the site shows a buyer.
- **Up to 1,000 places** per keyword, and no more pages than needed: the Actor stops as soon as all your products of the keyword
  are found.
- **Trend out of the box.** The previous place and the change come from a store in your account — no spreadsheet needed.
- **The whole top, not only your products.** Set **Top places to track** and see new competitors entering the first page and
  products that left it — without listing article numbers.
- **Per region.** Search results depend on the delivery region, and so do the places: pick Moscow, Saint Petersburg, Novosibirsk,
  Vladivostok or any `dest` code.

### How to use

1. Put **search words** and **article numbers** (or product links) into the input. Every product is looked for in the results of
   every keyword. For the top of a keyword, set **Top places to track** (up to 100) — article numbers are then optional.
2. Pick the delivery region.
3. Schedule the Actor. The first run gives places; the next ones also show the previous place and the change.

### Examples

Input:

```json
{
  "queries": ["термос"],
  "articles": ["683146715", "12011340"],
  "region": "moscow"
}
```

A row (shortened, illustrative numbers):

```json
{
  "status": "ok",
  "query": "термос",
  "article": 683146715,
  "found": true,
  "position": 8,
  "previous_position": 11,
  "position_change": 3,
  "checked_positions": 100,
  "total_results": 117479,
  "price": 1390.0,
  "checked_at": "2026-11-08T07:00:00+00:00"
}
```

### Pricing

| Event | Price | What it is |
|---|---|---|
| `position-check` | $0.0034 ($3.40 per 1,000) | a checked pair of a keyword and a product, found or not |
| `top-position` | $0.0007 ($0.70 per 1,000) | a row of the top tracking: a product in the top or one that left it |
| Actor start | $0.00425 | once per run at the default 1 GB of memory (Apify counts one more start for every GB above) |

`skipped` and `error` rows are free. A product not found within 1,000 places is a checked pair: it is charged. A run never charges
more than its maximum total charge. The **Pricing** tab always shows the current prices.

### Good to know

- **Places move fast.** In our test, after 70 minutes only 9 of the first 100 products of `термос` stood at the same place, and
  the typical move was 3 places. One check a day shows the trend; one check is not a fixed rank.
- **Ads.** Wildberries does not show visitors which places are paid, so the Actor does not mark them; it gives the place in the
  site's order.
- A product not found in the first 1,000 places gets `found: false` and an empty `position`.
- The **Store of previous positions** keeps only keywords, article numbers, places and dates. A pair not checked for 90 days is
  forgotten.
- A run of one keyword takes about 15–60 s on Apify, most of it the browser start; the deeper your products stand, the more pages
  the run reads (up to 10).
- **No charge for failures.** If the run gets no data, it ends with an error instead of empty rows, and those pairs 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-positions`: 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

- Only public search data: places, the product's name, brand and price. No seller details and no buyer data.
- The store of previous positions 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 Niche Analyzer](https://apify.com/theshark/wildberries-niche-analyzer) — a niche by keyword, category, shop or brand: brands, sellers, shares, prices.
- [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 в поиске.** Для каждого запроса и каждого артикула актор даёт **место в порядке сайта** в первых 1000
результатах, место на прошлом запуске и на сколько мест товар сдвинулся. Следите за своими товарами или за конкурентами: поставьте
в расписание раз в день и смотрите динамику. Или следите за **всем топом запроса**: кто вошёл на первые места, кто сдвинулся и кто
выпал с прошлого запуска.

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

- **Строка на пару «запрос и товар»**: `query`, `article`, `found`, `position` (с 1), `checked_positions`, `total_results`
  (товаров по запросу), `url`.
- **Изменение**: `previous_position`, `previous_checked_at`, `position_change` (плюс — вверх, минус — вниз).
- **Найденный товар**, как его показывает поиск: `name`, `brand`, `price` (к оплате, рубли).
- **Трекер топа** (**Мест топа отслеживать**): строка на каждый товар первых мест каждого запроса с `top_change` — `new` (вошёл в
  топ), `up`, `down`, `same` — и строка на каждый товар, который в прошлый раз был в топе, а теперь нет (`left`).
- **Статус в каждой строке**: `ok` (проверено, нашёлся или нет), `skipped`, `error`.

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

- **Настоящий порядок сайта.** Места считаются в том же порядке, что и в ответе поиска, который сайт показывает покупателю.
- **До 1000 мест** на запрос и ни одной лишней страницы: актор останавливается, как только нашёл все ваши товары запроса.
- **Динамика сразу.** Прошлое место и сдвиг берутся из хранилища вашего аккаунта — таблица не нужна.
- **Весь топ, а не только ваши товары.** Задайте **Мест топа отслеживать** — и видно, кто из конкурентов вошёл на первую страницу и
  кто с неё выпал, без списка артикулов.
- **По регионам.** Выдача зависит от региона доставки, а с ней и места: Москва, Санкт-Петербург, Новосибирск, Владивосток или
  любой код `dest`.

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

1. Укажите **слова поиска** и **артикулы** (или ссылки на товары). Каждый товар ищется в выдаче каждого запроса. Для топа запроса
   задайте **Мест топа отслеживать** (до 100) — тогда артикулы не обязательны.
2. Выберите регион доставки.
3. Поставьте актор в расписание. Первый запуск даст места, следующие — ещё и прошлое место со сдвигом.

#### Примеры

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

#### Цена

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

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

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

- **Места меняются быстро.** В нашей проверке через 70 минут из первых 100 товаров по запросу `термос` на том же месте стояли 9, а
  обычный сдвиг был 3 места. Проверка раз в день показывает тренд; одна проверка — не застывшее место.
- **Реклама.** Wildberries не показывает посетителю, какие места рекламные, поэтому актор их не отмечает: он даёт место в порядке
  сайта.
- Товар, не найденный в первых 1000 местах, получает `found: false` и пустой `position`.
- **Хранилище прошлых мест** хранит только запросы, артикулы, места и даты. Пара, которую 90 дней не проверяли, забывается.
- Запуск на один запрос на Apify занимает около 15–60 с, большая часть — запуск браузера; чем глубже стоят ваши товары, тем больше
  страниц читает запуск (до 10).
- **Сбой не оплачивается.** Если данных получить не удалось, запуск кончается ошибкой, а не пустыми строками, и такие пары
  бесплатны.
- **Кеш браузера.** Чтобы запуск начинался быстрее и тратил меньше трафика, скрипты сайта, которые скачал браузер, лежат в именованном
  хранилище в вашем аккаунте — `wildberries-browser-cache-positions`: без cookies, токенов и паролей. Его можно удалить в любой момент: следующий запуск просто
  начнётся медленнее.
- Актор не связан с Wildberries и читает только то, что сайт показывает любому посетителю.

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

- Только открытые данные поиска: места, название, бренд и цена товара. Ни реквизитов продавца, ни данных покупателей.
- В хранилище прошлых мест — только числа и даты: ни 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-niche-analyzer) — ниша по запросу, категории, магазину или бренду: бренды, продавцы, доли, цены.
- [Ключевые слова 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 product below is looked for in the results of every keyword; with Top places to track, the top of every keyword is tracked too.<br><br>Слова, как их набирает покупатель на сайте. Каждый товар ниже ищется в выдаче каждого слова; с «Мест топа отслеживать» отслеживается и топ каждого слова.

## `articles` (type: `array`):

Wildberries article numbers (nmId) whose place you want to know.<br><br>Артикулы Wildberries (nmId), чьё место вы хотите знать.

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

Links to products on wildberries.ru, instead of or besides article numbers.<br><br>Ссылки на товары на wildberries.ru — вместо артикулов или вместе с ними.

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

Search results 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: the run compares places with the last run that used the same store. It keeps only keywords, article numbers, places and dates. A pair not checked for 90 days is forgotten.<br><br>Именованное хранилище в вашем аккаунте: запуск сравнивает места с прошлым запуском с тем же хранилищем. Там только слова, артикулы, места и даты. Пара, которую 90 дней не проверяли, забывается.

## `top_size` (type: `integer`):

Optional. Track the first places of every keyword as a whole, all products, not only yours: who entered the top, who moved and who dropped out since the last run with the same store. Up to 100 places — the first search page. 0 — off.<br><br>Необязательно. Отслеживать первые места выдачи каждого запроса целиком, все товары, а не только ваши: кто вошёл в топ, кто сдвинулся и кто выпал с прошлого запуска с тем же хранилищем. До 100 мест — первая страница выдачи. 0 — выключено.

## `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"
  ],
  "articles": [
    "327310707"
  ],
  "urls": [],
  "region": "moscow",
  "history_store": "wildberries-position-history",
  "top_size": 0,
  "output_language": "en"
}
```

# Actor output Schema

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

One row per keyword and product: found or not, and the place; with top tracking, also a row per product of the top. Строка на запрос и товар: нашёлся ли и на каком месте; с трекером топа — ещё строка на каждый товар топа.

## `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"
    ],
    "articles": [
        "327310707"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("theshark/wildberries-search-position-tracker").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"],
    "articles": ["327310707"],
}

# Run the Actor and wait for it to finish
run = client.actor("theshark/wildberries-search-position-tracker").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"
  ],
  "articles": [
    "327310707"
  ]
}' |
apify call theshark/wildberries-search-position-tracker --silent --output-dataset

```

## MCP server setup

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

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/SBOZrtfWKHshnHdVQ/builds/FS3NKt3l1w3ro36HS/openapi.json
