Дата публикации: 17.03.2026
Отчёт Поисковые запросы по вашим товарам содержит:
Анализ поисковых запросов — основа SEO-оптимизации на маркетплейсах. С помощью анализа можно понять, по каким ключевым фразам ранжируются запросы, а также какие запросы приводят целевую аудиторию и конвертируются в заказы.
WB API Поисковых запросов по вашим товарам подходит для всех моделей продаж. Используйте эти методы, чтобы:
Отслеживать, как меняются позиции товаров в поиске по ключевым запросам
Анализировать факторы ранжирования, чтобы понимать, какие параметры влияют на место карточки в результатах поиска и как их можно улучшить
Оценивать видимость товаров — вероятность того, что покупатель увидит вашу карточку в поиске
Формировать семантическое ядро, чтобы находить новые перспективные запросы, по которым уже показываются товары, и отсеивать запросы, которые не приводят к заказам
Анализировать конверсии по запросам, чтобы отслеживать, как часто пользователи переходят в карточку из поиска, добавляют товар в корзину и оформляют заказы
Оптимизировать рекламные кампании за счёт расширения семантики успешными запросами и отсечения нецелевого трафика
В разделе Поисковые запросы по вашим товарам WB API пять методов. Чтобы выбрать подходящий, ориентируйтесь на свою задачу.
Методы Поисковых запросов по вашим товарам доступны только при наличии подписки Джем. Так же, как и в методах Воронки продаж, данные возвращаются максимум за последние 365 дней с момента выполнения запроса. Чтобы проанализировать более долгие периоды, рекомендуем регулярно сохранять полученные данные
Метод POST /api/v2/search-report/report формирует сводную аналитику о выдаче товаров в результатах поиска.
Используйте метод, чтобы мониторить эффективность SEO-оптимизации:
Методы Поисковых запросов по вашим товарам не хранят информации о сроках доставки товаров по регионам. Чтобы отследить влияние этих изменений на видимость карточек товаров в результатах поиска, рекомендуем использовать методы Истории остатков
Метод POST /api/v2/search-report/table/groups возвращает данные по товарам, сгруппированным по предметам, брендам или ярлыкам.
Используйте метод, чтобы решать задачи категорийного управления:
Метод POST /api/v2/search-report/table/details возвращает данные по конкретным товарам внутри выбранной группы.
Позиции товара в результатах поиска персонализированы и могут различаться для разных покупателей. В методах Поисковых запросов по вашим товарам используется средняя позиция товара по всем показам за период. Это позволяет сгладить индивидуальные отклонения и оценить реальное ранжирование
Используйте метод, чтобы решать оперативные задачи:
Методы Поисковых запросов по вашим товарам не хранят историю изменений карточки, например, цены, описания или обложки товара. Чтобы отследить, как эти изменения влияют на показы товара в результатах поиска, рекомендуем:
• cохранять информацию об изменениях карточек товаров с указанием дат
• сопоставлять сохранённые события с данными API
Метод POST /api/v2/search-report/product/search-texts возвращает топ поисковых запросов, по которым конкретный товар показывался пользователям в результатах поиска.
Используйте метод, чтобы решать задачи расширения семантического ядра:
Максимальное количество запросов в ответе метода POST /api/v2/search-report/product/search-texts — 30. Для тарифов Продвинутый и Премиальный — 100
Метод POST /api/v2/search-report/product/orders возвращает данные о заказах по каждому поисковому запросу для конкретного товара и позициях товара в результатах поиска по этому запросу. Данные отчёта сгруппированы по дням, максимальный интервал— 7 дней.
Используйте метод, чтобы решать задачи оценки коммерческой эффективности запросов:
Для работы с большими объёмами данных используйте специализированные CSV-отчёты Поисковых запросов по вашим товарам:
SEARCH_QUERIES_PREMIUM_REPORT_PRODUCT — детализированные данные по параметрам поиска по каждому артикулуSEARCH_QUERIES_PREMIUM_REPORT_GROUP — агрегированная статистика по параметрам поиска по предметам, брендам, ярлыкамSEARCH_QUERIES_PREMIUM_REPORT_TEXT — данные по текстам поисковых запросов (семантическое ядро)Данные в отчётах Поисковых запросов по вашим товарам представлены максимум за 365 дней и доступны с подпиской Джем
Чтобы получить CSV-отчёт, соблюдайте порядок действий:
Выполните запрос метода POST /api/v2/nm-report/downloads. В теле запроса укажите:
SEARCH_QUERIES_PREMIUM_REPORT_GROUPОтчёт формируется не сразу. Чтобы проверить статус генерации отчёта, используйте метод GET /api/v2/nm-report/downloads.
Когда статус сменится на SUCCESS, отчёт будет готов. Файлы хранятся 48 часов.
Если вы получили статус FAILED, отправьте запрос POST /api/v2/nm-report/downloads/retry, чтобы сгенерировать отчёт повторно
Готовый CSV-отчёт будет сгенерирован в ZIP-архив. Скачайте его с помощью метода GET /api/v2/nm-report/downloads/file/{downloadId}.
Методы Воронки продаж собирают статистику по всем товарам продавца. В зависимости от задачи вы можете настроить выгрузку товаров с помощью фильтров:
selectedPeriod и pastPeriod — запрашиваемый период и период для сравнения. Вы можете задать произвольный интервал в пределах доступных дат.nmIds — артикулы WB — отбор по конкретным товарам из вашего каталога.brandNames — бренды товаров.subjectIds — предметы по классификации Wildberries.tagIds — ярлыки продавца, которые можно указать в карточке товара.Если вы комбинируете несколько фильтров, например, указываете и бренд, и категорию, — в ответ попадут только те карточки товаров, которые соответствуют всем условиям одновременно
Полезные ссылки в справочном центре: