API Wildberries и Ozon для селлера: что умеет и как подключить

Евгения Елисеева · Обновлено 10.08.2026 · 10 мин

API Wildberries и Ozon — это способ управлять магазином не руками в кабинете, а через программу: обновлять цены и остатки, забирать заказы, выгружать отчёты. Маркетплейс отдаёт данные по протоколу HTTP, а принимает их сервис аналитики, учётная система или ваш собственный скрипт.

Статья для селлеров, у которых ассортимент вырос настолько, что ручное обновление съедает часы. Здесь — где в кабинете взять ключ на каждой площадке, чем Seller API отличается от Performance API, сколько живёт токен, какие есть лимиты и куда смотреть в документации.

Сразу разведём понятия. WB API и Ozon API — не кнопка и не сервис. Это интерфейс, через который чужая программа обращается к вашему магазину, а ключ подтверждает, что обращение законное.

Что такое API и API-ключ простыми словами

API (Application Programming Interface) — набор правил, по которым одна программа запрашивает данные у другой. Маркетплейс публикует список методов: «отдай остатки по складам», «поставь такую цену», «пришли заказы за сегодня». Сервис вызывает нужный метод и получает ответ в машинном формате.

API-ключ (он же токен) — длинная строка, которая подтверждает, что запрос идёт от вашего магазина. Для программы токен заменяет логин и пароль. Отсюда главное правило: ключ хранят как пароль. Wildberries прямо предупреждает, что токен открывает доступ к данным профиля WB Партнёров, и советует передавать его только тем разработчикам, в которых вы уверены.

Разница между площадками начинается уже здесь. У Wildberries ключ один, но с выбранными областями доступа. У Ozon для основной работы нужна пара значений, а для рекламы — вообще отдельный механизм.

Что селлер получает через WB API и Ozon API

Через API закрывают то, что при большом ассортименте неудобно делать руками:

• обновление остатков сразу по всем складам;
• массовая смена цен перед акцией;
• выгрузка заказов в учётную систему или 1С;
• сбор отчётов по продажам, возвратам и удержаниям;
• печать этикеток для отгрузки пачкой, а не по одной;
• своя аналитика: данные выгружают в таблицу или BI и считают метрики так, как нужно бизнесу.

Wildberries называет главным преимуществом API интеграцию с системами продавца — ERP, WMS, OMS, CRM. Смысл в том, что магазин перестаёт быть отдельным островом: остатки и заказы живут там же, где остальной учёт.

Если пока не решили, строить свою выгрузку или взять готовый сервис, — сравнение вариантов есть в статье про аналитику маркетплейсов. Новичку API не нужен: сначала осваивают кабинет, а к интеграции возвращаются, когда заказов становится много.

WB API: токены, категории данных и сроки

Портал разработчика Wildberries живёт на отдельном домене dev.wildberries.ru: там документация в формате Swagger OpenAPI, журнал изменений, песочница и статус API. Токен при этом создаётся не там, а в кабинете продавца.

Где создать токен в кабинете WB

Раздел называется «Интеграции по API». В нём три вещи: создание токенов, список уже созданных и подключение готовых решений из каталога сервисов.

Что важно знать про токены Wildberries до того, как создадите первый:

Последний пункт — типовая причина ошибки на старте: ключ создан, а метод возвращает 401 или 403, потому что категория токена не совпадает с категорией API.

OAuth 2.0: подключение сервиса без передачи токена

Кроме токенов Wildberries поддерживает подключение сервисов по OAuth 2.0 — в кабинете это названо упрощённым способом. Разница принципиальная: вы не копируете строку токена в чужой интерфейс, а выдаёте сервису доступ, который видно в списке подключённых и можно отозвать. Для готовых решений из каталога это безопаснее ручной передачи ключа.

Ozon API: Seller API и Performance API

У Ozon два разных API, и путать их — типовая ошибка. Оба живут в кабинете в разделе «Настройки» → «API интеграции», но настраиваются по-разному.

Seller API: товары, заказы, остатки

Ozon Seller API отвечает за товары, цены, остатки, заказы и отгрузки — это основной интерфейс для интеграций. Для авторизации нужны два значения: Client ID и API key. Client ID показан в кабинете, ключ создаётся кнопкой «Сгенерировать ключ» на вкладке Seller API.

Три вещи, которые стоит знать до создания ключа. Первая: срок действия ключа — 6 месяцев, после этого генерируется новый; дату истечения отдаёт и сам API — параметр expires_at метода /v1/roles. Вторая: ключей можно создать несколько — например, под разных пользователей с разными уровнями доступа. Третья: при создании выбирается уровень доступа и назначение ключа — для личного пользования или для внешнего сервиса.

Документация Seller API делит методы на группы: базовые, бета-методы, Premium-методы, отдельно Ozon Доставка и пуш-уведомления, плюс раздел обновлений. На группу Premium стоит посмотреть до того, как проектировать интеграцию вокруг конкретного отчёта: она вынесена отдельно, и условия доступа к ней описаны в самой документации.

Performance API: только реклама

Ozon Performance API — отдельный интерфейс для рекламного кабинета: кампании, статистика, оплата за клик и за заказ, аналитика внешнего трафика. У него свой хост и своя схема авторизации, поэтому ключами Seller API он не настраивается.

Устроено иначе: при необходимости создаётся сервисный аккаунт, и уже к нему подключаются ключи — к одному аккаунту их может быть несколько. Пара значений называется client_id и client_secret; по ним сервис получает авторизационный токен, а когда срок токена истекает — запрашивает новый.

OAuth-доступы и частные приложения

В том же разделе кабинета Ozon есть ещё две вкладки. OAuth-доступы — список сервисов, которым вы выдали доступ; сам доступ выдаётся через магазин приложений, а на этой вкладке видно, кому он уже открыт. Управление частными приложениями — для тех, кто делает собственное приложение под свой кабинет.

Как получить API-ключ: пошагово для обеих площадок

Порядок похожий, отличаются названия разделов.

На Wildberries

• 1
  Откройте в кабинете продавца раздел «Интеграции по API».
• 2
  Нажмите «Создать токен».
• 3
  Выберите тип токена (Персональный, Сервисный, Базовый или Тестовый), задайте имя, отметьте категории данных и уровень доступа — только чтение либо чтение и запись.
• 4
  Скопируйте токен сразу: показывается он один раз.
• 5
  Вставьте токен в настройки сервиса либо передайте разработчику своей интеграции.

На Ozon

• 1
  Откройте «Настройки» → «API интеграции».
• 2
  На вкладке Seller API скопируйте Client ID и нажмите «Сгенерировать ключ».
• 3
  Для рекламы перейдите на вкладку Performance API и нажмите «Создать аккаунт» — это сервисный аккаунт, к которому потом добавляются ключи.
• 4
  Проверьте связку до того, как настраивать остальное: документация Ozon предлагает делать пробные запросы во вкладке «Консоль» или в Postman.

Где документация по API Wildberries и Ozon

Искать методы стоит только в официальных справочниках: у обеих площадок они открытые и обновляются вместе с API.

Документация Wildberries отдаётся в формате OpenAPI — её можно импортировать в Postman или сгенерировать по ней клиентский код. Для ручной проверки запросов площадка советует Postman на Windows и curl на Linux.

Лимиты, ошибки и безопасность

У запросов есть потолок: превысите — ответы начнут приходить с ошибкой, и выгрузка встанет посреди работы.

Wildberries отдаёт остаток лимита в заголовке X-Ratelimit-Remaining — это количество запросов, которое можно выполнить прямо сейчас без пауз. Значение уменьшается с каждым запросом и восстанавливается со временем; если оно дошло до нуля и запрос всё равно ушёл, в ответ придёт 429. Заголовок есть во всех ответах, кроме самой ошибки 429 — а в ней приходят X-Ratelimit-Retry, X-Ratelimit-Limit и X-Ratelimit-Reset, по которым понятно, сколько ждать. Это и стоит читать в коде, а не подбирать паузы наугад.

Что означают коды, которые чаще всего видит селлер:

Платный доступ к WB API: кого это касается

Wildberries ввела для внешних сервисов модель pay-as-you-go — оплату за фактическое использование API вместо подписки. Одновременно появились сервисные токены с изолированными лимитами: их и повышенные лимиты можно получить и не вступая в Каталог решений, по заявке.

Селлера это касается косвенно. Платёжная ошибка в WB API — код 402 — по справке возвращается только сервисам из Каталога решений для бизнеса, то есть при работе со своим токеном вы её не увидите. А если пользуетесь готовым сервисом, стоимость обращений к API теперь часть его экономики — при продлении тарифа стоит уточнить, что изменилось.

Апи ВБ и апи Озон: главное коротко

Сводка для тех, кто ищет по-русски «апи ВБ» или «апи Озон» и хочет ответ одним экраном:

Частые вопросы