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

Евгения Елисеева · Обновлено 13.09.2026 · 12 мин

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 до того, как создадите первый:

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

Четыре типа токена WB: какой отдавать стороннему сервису

При создании кабинет просит выбрать тип токена, и от него зависит, кому ключ можно передавать. Из справки портала и подсказки «О токенах» в кабинете:

Практический вывод: для стороннего сервиса аналитики или учёта — Сервисный, если сервис есть в каталоге, иначе Базовый. Персональный оставьте для собственных систем. Лимиты у типов тоже разные: в примере из справки для категории Маркетплейс персональному и сервисному токену даётся 300 запросов в минуту, базовому и тестовому — 150.

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.

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

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

Типы токена Ozon: какие роли выбрать для ключа

Самая непонятная часть формы «Генерация ключа» — таблица «Типы токена» с четырьмя десятками строк: Brand, Company, Barcode, Product, Stocks и так далее. Это роли ключа: каждая открывает свою группу методов API, а справа в таблице стоит число методов, которые она даёт. У большинства ролей две версии — полная и read-only, только чтение. Ключ работает лишь с теми методами, которые входят в отмеченные роли; какие роли и методы привязаны к готовому ключу, можно проверить методом /v1/roles.

Перед таблицей ролей форма спрашивает цель использования ключа: «Для личного использования» (аналитика, интеграция с 1С) или «Для внешнего сервиса, приложения» — во втором случае появляется поле с названием сервиса. Отдельная вкладка «Разрешенные сети» позволяет ограничить ключ диапазоном IP-адресов в нотации CIDR: например, 10.0.0.1/32 — доступ только с одного адреса. Заполнять её необязательно.

Роли, которые закрывают типовые задачи селлера:

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

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

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

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

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

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

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

На Wildberries

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

На Ozon

• 1
  Откройте «Настройки» → «API интеграции».
• 2
  На вкладке Seller API скопируйте Client ID и нажмите «Сгенерировать ключ».
• 3
  В форме задайте название ключа, выберите цель использования — для личного использования или для внешнего сервиса с его названием — и отметьте типы токена: для сервиса, который только читает данные, хватит Admin read only. Нажмите «Сгенерировать» и сразу сохраните ключ: второй раз кабинет его не покажет.
• 4
  Для рекламы перейдите на вкладку Performance API и нажмите «Создать аккаунт» — это сервисный аккаунт, к которому потом добавляются ключи.
• 5
  Проверьте связку до того, как настраивать остальное: документация 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 вместо подписки. Сервисный секрет и повышенные лимиты можно получить и не вступая в Каталог решений — по заявке.

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

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

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

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