# Wildberries Keyword Scraper · Ключевые слова Wildberries (`theshark/wildberries-keyword-scraper`) Actor

Search keywords Wildberries suggests to buyers: search box suggestions and related searches for your seed words, two levels deep. Ключевые слова, которые Wildberries подсказывает покупателям: подсказки строки поиска и связанные запросы, на две ступени вглубь.

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

## Pricing

from $1.70 / 1,000 keyword · запрос

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 Keyword Scraper · Ключевые слова Wildberries

Find the **search keywords Wildberries itself offers buyers**. For every seed word you give, the Actor collects what the site suggests
in its search box — continuations of the typed words and ready searches — and the **related searches** of the search page, one or
two levels deep, optionally with the **number of products** for every keyword. One row per keyword, ready for a product card, an
ad campaign or a niche list.

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

### What you get

- **The keyword**: `keyword` as the site gives it, and `url` — the search for it on the site.
- **Where it came from**: `seed` (your word), `parent` (the query the site gave it for), `source` — `hint_tag` (a continuation of
  the typed words), `hint_suggestion` (a ready search from the search box) or `related` (a related search of the search page),
  `position` in the site's answer and `depth` (1 or 2).
- **Competition**, if you ask for it: `product_count` — how many products the site finds for the keyword.
- **A status in every row**: `ok` for a keyword; a row without a keyword tells what happened to a seed word: `no_results`,
  `partial`, `skipped`, `error`.

### Why this Actor

- **The words the site steers buyers to.** Search box suggestions are what a buyer sees while typing, so they are the searches
  buyers actually pick.
- **Two sources in one run**: the search box and the related searches of the search page.
- **Two levels deep**: at depth 2 every keyword found for your word is expanded too: in our check one word gave 11 keywords at
  depth 1 and 83 more long-tail ones at depth 2.
- **Every keyword once.** A keyword that several seed words or sources lead to is one row per run, so you do not pay twice.
- **Product count** shows how crowded each keyword is.
- **Pay only for keywords.** Seed words with nothing new, lost answers and errors are free.

### How to use

1. Put your **seed words** into the input — as a buyer starts typing them, up to 100.
2. Pick the **depth**: 1 — keywords for your words, 2 — also keywords for every keyword found.
3. Keep **Related searches** on or turn it off; turn **Product count for every keyword** on if you need it.
4. Pick the delivery region and run it. The **Keywords** view shows the rows as a table.

### Examples

Input:

```json
{
  "queries": ["термос", "блузка"],
  "depth": 1,
  "with_related": true,
  "with_product_count": false,
  "region": "moscow"
}
```

Rows from our test runs (shortened: without `url`, `region_dest` and `checked_at`; `product_count` is from a run with the
product count option):

```json
[
  {"status": "ok", "status_note": null, "keyword": "термос 1 литр", "seed": "термос", "parent": "термос",
   "source": "hint_tag", "position": 1, "depth": 1, "product_count": 72694},
  {"status": "ok", "status_note": null, "keyword": "термокружка", "seed": "термос", "parent": "термос",
   "source": "related", "position": 2, "depth": 1, "product_count": null},
  {"status": "ok", "status_note": null, "keyword": "блузка женская нарядная белая", "seed": "блузка",
   "parent": "блузка женская нарядная", "source": "hint_tag", "position": 4, "depth": 2, "product_count": null},
  {"status": "no_results", "status_note": "the site suggested no new keywords", "keyword": null, "seed": "ывапролдж",
   "parent": null, "source": null, "position": null, "depth": null, "product_count": null}
]
```

### Pricing

| Event | Price | What it is |
|---|---|---|
| `keyword` | $0.0017 ($1.70 per 1,000) | a keyword found |
| `keyword-with-count` | $0.003 ($3 per 1,000) | a keyword with its product count (one more search page for every keyword) |
| Actor start | $0.00425 | once per run at the default 1 GB of memory (Apify counts one more start for every GB above) |

A keyword whose product count did not come is charged as `keyword`. Rows without a keyword are free. A run never charges more
than its maximum total charge. The **Pricing** tab always shows the current prices.

### Good to know

- **No search volume.** Wildberries does not show visitors how often a keyword is searched, so there is no frequency in the data.
  `position` is the place in the site's own list.
- **Region.** The search box suggestions do not depend on it: in our check Moscow and Vladivostok gave the same answer. Related
  searches and product counts are taken for the chosen region.
- **Related searches cost a search page.** The site asks for them with the product count of the search, so for every expanded
  keyword the run first opens one search page. Turn them off for a fast and light run.
- **Depth 2** expands every keyword found at depth 1, one more request each: in our check 11 keywords became 94.
- A search with no products has no related searches: the site gives none for it.
- **Speed.** At the default 1 GB of memory, once the browser has started, a seed word takes 5–6 s at depth 1 with related
  searches; 94 keywords at depth 2 without them took 20 s, and 3 keywords with product counts 10 s.
- **No charge for failures.** If the run gets no data, it ends with an error instead of empty rows; those rows 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-keywords`: 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 search volume and nothing from a seller's account: the Actor does not log in and uses no seller tokens.
- No buyer data: only the keywords the site shows to everyone.

### 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 Niche Analyzer](https://apify.com/theshark/wildberries-niche-analyzer) — a niche by keyword, category, shop or brand: brands, sellers, shares, prices.

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 сам подсказывает покупателям.** К каждому слову-затравке актор собирает подсказки строки
поиска — продолжения набранных слов и готовые запросы — и **связанные запросы** страницы поиска, на одну или две ступени вглубь, по
желанию — с **числом товаров** по каждому запросу. Одна строка на запрос — для карточки товара, рекламы или списка ниш.

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

- **Запрос**: `keyword`, как его дал сайт, и `url` — поиск по нему на сайте.
- **Откуда он**: `seed` (ваше слово), `parent` (к какому запросу сайт его дал), `source` — `hint_tag` (продолжение набранных слов),
  `hint_suggestion` (готовый запрос из строки поиска) или `related` (связанный запрос страницы поиска), `position` — место в ответе
  сайта и `depth` (1 или 2).
- **Конкуренция**, если попросить: `product_count` — сколько товаров сайт находит по запросу.
- **Статус в каждой строке**: `ok` — запрос; строка без запроса говорит, что стало со словом из входа: `no_results`, `partial`,
  `skipped`, `error`.

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

- **Слова, к которым сайт ведёт покупателя.** Подсказки строки поиска покупатель видит, пока набирает, поэтому их он и выбирает.
- **Два источника за запуск**: строка поиска и связанные запросы страницы поиска.
- **Две ступени**: на глубине 2 каждый найденный запрос расширяется тоже: в нашей проверке одно слово дало 11 запросов на глубине 1
  и ещё 83 длинных на глубине 2.
- **Каждый запрос один раз.** Запрос, к которому ведут несколько слов или источников, — одна строка на запуск: дважды не платите.
- **Число товаров** показывает, насколько запрос занят.
- **Платите только за запросы.** Слова без новых запросов, потерянные ответы и ошибки бесплатны.

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

1. Укажите **слова-затравки** — так, как покупатель начинает их набирать, до 100.
2. Выберите **глубину**: 1 — запросы к вашим словам, 2 — ещё и к каждому найденному.
3. Оставьте или выключите **Связанные запросы**; включите **Число товаров по каждому запросу**, если нужно число товаров.
4. Выберите регион доставки и запустите. Вид **Keywords** показывает строки таблицей.

#### Примеры

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

#### Цена

| Событие | Цена | За что |
|---|---|---|
| `keyword` | $0,0017 ($1,70 за 1000) | найденный запрос |
| `keyword-with-count` | $0,003 ($3 за 1000) | запрос с числом товаров (ещё страница выдачи на каждый запрос) |
| Запуск | $0,00425 | раз на запуск при памяти по умолчанию 1 ГБ (Apify считает ещё один запуск за каждый ГБ сверх) |

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

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

- **Частоты нет.** Сколько раз запрос ищут, Wildberries посетителю не показывает, поэтому частоты в данных нет. `position` — место
  в списке самого сайта.
- **Регион.** Подсказки строки поиска от него не зависят: в нашей проверке Москва и Владивосток дали один и тот же ответ. Связанные
  запросы и число товаров берутся по выбранному региону.
- **Связанные запросы стоят страницы выдачи.** Сайт просит их с числом товаров поиска, поэтому к каждому расширяемому запросу актор
  сначала открывает страницу выдачи. Выключите их для быстрого и лёгкого запуска.
- **Глубина 2** расширяет каждый запрос глубины 1, по запросу на каждый: в нашей проверке 11 запросов стали 94.
- У поиска без товаров связанных запросов нет: сайт их не даёт.
- **Скорость.** При памяти по умолчанию 1 ГБ, после запуска браузера, слово на глубине 1 со связанными занимает 5–6 с; 94 запроса
  на глубине 2 без них заняли 20 с, а 3 запроса с числом товаров — 10 с.
- **Сбой не оплачивается.** Если данных получить не удалось, запуск кончается ошибкой, а не пустыми строками; такие строки бесплатны.
- **Кеш браузера.** Чтобы запуск начинался быстрее и тратил меньше трафика, скрипты сайта, которые скачал браузер, лежат в именованном
  хранилище в вашем аккаунте — `wildberries-browser-cache-keywords`: без cookies, токенов и паролей. Его можно удалить в любой момент: следующий запуск просто
  начнётся медленнее.
- Актор не связан с Wildberries и читает только то, что сайт показывает любому посетителю.

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

- Частоты и данных из кабинета продавца нет: актор не входит в аккаунт и не берёт токенов продавцов.
- Данных покупателей нет: только запросы, которые сайт показывает всем.

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

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-niche-analyzer) — ниша по запросу, категории, магазину или бренду: бренды, продавцы, доли, цены.

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

- [Парсер 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`):

Words or phrases as a buyer starts typing them on the site, up to 100. For every one the run collects what the site suggests.<br><br>Слова или фразы — как покупатель начинает их набирать на сайте, до 100. К каждому запуск собирает, что подсказывает сайт.

## `depth` (type: `integer`):

1: keywords for your seed words. 2: also keywords for every keyword found at depth 1, one more request each: in our check 11 keywords became 94.<br><br>1 — запросы к вашим словам. 2 — ещё и к каждому запросу глубины 1, по запросу на каждый: в нашей проверке 11 запросов стали 94.

## `with_related` (type: `boolean`):

Besides the search box suggestions, take the related searches the site shows on the search page. The site needs the product count of the search for them, so each expanded keyword costs one more search page of traffic and time.<br><br>Кроме подсказок строки поиска — связанные запросы со страницы поиска. Сайт просит их с числом товаров выдачи, поэтому каждый расширяемый запрос стоит ещё одной страницы выдачи: трафика и времени.

## `with_product_count` (type: `boolean`):

Number of products the site finds for each keyword: one search page per keyword, so these rows have their own, higher price.<br><br>Сколько товаров сайт находит по каждому запросу: страница выдачи на запрос, поэтому у таких строк своя, более высокая цена.

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

Related searches and product counts are taken for this delivery region; the search box suggestions do not depend on it.<br><br>Связанные запросы и число товаров берутся по этому региону доставки; подсказки строки поиска от него не зависят.

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

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

## `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"
  ],
  "depth": 1,
  "with_related": true,
  "with_product_count": false,
  "region": "moscow",
  "output_language": "en"
}
```

# Actor output Schema

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

One row per keyword found, and a row for a seed word when nothing new was found, not every answer came, or the spending limit ran out. Строка на найденный запрос и строка на слово из входа, если нового нет, не все ответы пришли или кончился лимит трат.

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

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

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,theshark/wildberries-keyword-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/ycuv97mK9h4ZcZXVs/builds/HYv0YOCiyuBjH5dcW/openapi.json
