Что такое API Ozon и кому он нужен
API Ozon - набор методов, через которые программа получает данные кабинета продавца или вносит изменения без ручной работы в браузере. Программа отправляет запрос на адрес Ozon и передает Client ID и API-ключ: так Ozon понимает, чей это магазин и что ключу разрешено.
У продавца два API:
- Seller API - товары, цены, остатки, заказы FBO и FBS, поставки, финансы, возвраты, отзывы, аналитика. Документация - docs.ozon.ru/api/seller.
- Performance API - рекламный кабинет: кампании, расход, статистика, ставки. Документация - docs.ozon.ru/api/performance. Ключ для него создается отдельно.
Кому это нужно: продавцу, который подключает учетную систему, складскую программу, сервис аналитики или пишет свою выгрузку на Python, PHP или в 1С - для API это обычные HTTP-запросы с JSON. Писать запросы самому продавцу почти никогда не нужно: задача сводится к тому, чтобы правильно выпустить ключ и не выдать лишних прав.
Как получить API-ключ Ozon Seller: пошагово
Ключ создает владелец кабинета или сотрудник с правами администратора. Порядок на октябрь 2026 года:
- Откройте кабинет Ozon Seller: меню профиля → «Настройки» → «API ключи» (в части кабинетов раздел называется «API интеграции»), вкладка «Seller API». Прямая ссылка: seller.ozon.ru/app/settings/api-keys.
- Скопируйте Client ID - число, номер вашего магазина в API. Он виден на этой же странице.
- Нажмите «Сгенерировать ключ» и дайте ему понятное название: сервис и месяц, например «Аналитика 10.2026». По названию потом легко найти и отключить нужный ключ.
- Выберите роль. Для аналитики и отчетов - «Admin read only», подробнее в следующем разделе.
- Скопируйте ключ сразу и целиком. Ozon показывает его один раз: закрыли окно - создайте новый ключ, а старый удалите.
- Вставьте Client ID и ключ в сервис сами, в его защищенное поле. Не пересылайте их почтой и в мессенджерах.
Если кнопки создания ключа нет, вашей учетной записи не хватает прав. Попросите владельца кабинета выдать роль администратора или создать ключ самому.
Какую роль API-ключа Ozon выбрать
Короткий ответ: ровно столько прав, сколько нужно задаче. Роль определяет, какие методы ключ может вызывать.
| Задача | Роль ключа | Почему |
|---|---|---|
| Аналитика, прибыль, остатки, отчеты | «Admin read only» (только чтение) | Читает данные кабинета и ничего не меняет |
| Учетная система выгружает товары, цены и остатки | Роль с правом изменений, например «Admin» | Без права записи цены и остатки не обновятся |
| Ответы на отзывы, вход в акции, заявки на поставку | Роль с правом изменений в этих разделах | Ключ на чтение не может отправлять изменения |
| Ставки и статистика рекламы | Отдельный рекламный ключ | Ключ магазина рекламными кампаниями не управляет |
Правило из практики агентства GreenMP: один сервис - один ключ. При смене подрядчика вы отключаете только его ключ, а остальные интеграции работают дальше. Ключ создает владелец и вводит в сервис сам, а не присылает в общий чат.
Что умеет готовый ключ, показывает метод /v1/roles: он возвращает роли ключа, доступные методы и дату окончания срока. Аккуратный сервис вызывает его при подключении и не трогает то, чего ключ не умеет.
Client ID и API-ключ Ozon: в чем разница
Client ID - постоянный номер магазина в API. Сам по себе доступа он не дает, но вместе с ключом однозначно указывает на ваш кабинет. API-ключ - секрет, длинная строка символов. Кто знает пару Client ID и ключ, работает с кабинетом в пределах роли ключа.
В запросах они передаются в заголовках Client-Id и Api-Key, адрес методов - api-seller.ozon.ru. У рекламного API своя пара: client_id и client_secret, по ним программа получает временный токен доступа.
Частая путаница: идентификатор рекламного кабинета и Client ID магазина - разные значения. Если сервис просит оба, не вставляйте одно и то же число в два поля.
Сколько действует ключ и какие лимиты у Ozon API
С 3 сентября 2026 года новые ключи Seller API действуют 3 месяца - так сообщил официальный канал Ozon для разработчиков. У ключей, созданных раньше, срок может быть другим: дата окончания видна в списке ключей кабинета и в ответе метода /v1/roles.
Что из этого следует:
- поставьте напоминание за неделю до окончания срока: Ozon перестает принимать просроченный ключ, и данные в сервисах замирают;
- новый ключ выпускайте с той же ролью, вставьте в сервис, убедитесь, что данные обновились, и только потом удалите старый;
- удобнее, когда сервис сам показывает срок ключа: в кабинете SkuScan он виден в настройках подключения Ozon.
Лимиты запросов. У Ozon есть общее ограничение частоты запросов на один Client ID и отдельные, более строгие лимиты у части методов, например у аналитики. При превышении API отвечает ошибкой 429. С 25 сентября в ответах API есть заголовки рейт-лимитов: по ним программа видит остаток запросов и вовремя делает паузу.
Подписки. Часть данных через API доступна только с платными подписками Ozon для продавцов: расширенная аналитика (воронка показов и посещений, позиции в поиске) и работа с отзывами. Требование указано в описании каждого метода.
Performance API Ozon: ключ для рекламы
Performance API - отдельный API рекламного кабинета Ozon. Через него сервисы получают кампании, расход, показы, клики и заказы из рекламы по товарам, а с правом изменений - меняют ставки. Без этого ключа сервис видит только общую сумму, которую Ozon удержал за продвижение в начислениях, без разбивки по кампаниям и товарам.
Как создать ключ:
- В кабинете Ozon Seller: «Настройки» → «API ключи», вкладка «Performance API».
- Создайте сервисный аккаунт и добавьте ему ключ.
- Скопируйте client_id и client_secret. Секрет, как и основной ключ, вводите только в защищенное поле сервиса.
Программа обменивает client_id и client_secret на временный токен и сама обновляет его, вручную ничего продлевать не нужно. Отчеты по рекламе этот API формирует по запросу: сначала заказ отчета, потом файл, поэтому статистика за длинный период приходит не мгновенно. Как устроены сами рекламные инструменты, разобрали в статье реклама на Ozon.
Что можно сделать через Seller API Ozon
| Раздел | Что делает программа | Кому нужно |
|---|---|---|
| Товары и карточки | Создает и обновляет товары, характеристики, фото, штрихкоды, сертификаты | Учетные системы, сервисы контента |
| Цены и остатки | Обновляет цены и остатки FBS, получает комиссии и индекс цен | Учетные и складские программы |
| Заказы FBS и realFBS | Получает новые отправления, подтверждает сборку, печатает этикетки | Свой склад, фулфилмент |
| FBO | Получает остатки по кластерам и отправления, создает черновики заявок на поставку | Планирование поставок |
| Финансы | Начисления по дням, отчет о реализации, баланс | Учет, расчет прибыли |
| Аналитика | Продажи и выручка по товарам, поисковые запросы | Сервисы аналитики |
| Отзывы и вопросы | Получает и отвечает (с подпиской Ozon) | Сервисы ответов |
| Рейтинги | Рейтинги продавца и индекс ошибок FBS | Контроль штрафов |
| Push-уведомления | Ozon сам присылает событие о новом заказе или изменении | Интеграции в реальном времени |
Песочница. С 19 октября 2026 года у API продавца есть sandbox - тестовая среда, но только для методов Ozon Доставки. Остальные методы проверяйте на рабочем кабинете ключом только на чтение: чтение ничего не изменит.
Методы обновляются. Ozon регулярно выпускает новые версии и отключает старые: например, 8 сентября отключены прежние методы списка финансовых транзакций. Если пишете свою интеграцию, следите за разделом изменений в документации, иначе выгрузка однажды молча сломается.
OAuth. Сервисы из «Магазина приложений» Ozon могут подключаться по протоколу OAuth 2.0: вы подтверждаете доступ в кабинете, без копирования ключа.
Безопасность ключа: 7 правил
- Для аналитики - только «Admin read only».
- Логин и пароль от кабинета не давайте никому: для сотрудников есть отдельные доступы с ролями, для сервисов - ключи.
- Не пересылайте ключ в чаты, почту и таблицы. Засветился - удалите его в кабинете и выпустите новый.
- Один сервис - один ключ с понятным названием.
- Заодно с заменой по сроку удаляйте ключи сервисов, которыми больше не пользуетесь.
- Ключ с правом записи давайте только сервису, чьи действия видно: журнал изменений, подтверждение, откат.
- Спросите сервис, где хранится ключ. Правильный ответ - на сервере в зашифрованном виде, а не в браузере.
Подробный разбор рисков - в ответе безопасно ли давать сервису токен кабинета.
Как подключить магазин Ozon к сервису аналитики по ключу только на чтение
Порядок на примере кабинета SkuScan:
- Выпустите в Ozon ключ с ролью «Admin read only», как описано выше.
- В кабинете SkuScan откройте «Настройки» → Ozon и вставьте Client ID и ключ.
- SkuScan спросит у Ozon роли и срок ключа. Если у ключа роль «Admin», магазин подключится, но кабинет предупредит: для чтения хватает «Admin read only», такой ключ безопаснее.
- По желанию добавьте ключ Performance API - тогда в разделе «Реклама» появятся расход и заказы по кампаниям и товарам.
Первая загрузка идет несколько минут в фоне. Дальше видно прибыль по каждому товару по начислениям Ozon (комиссия, логистика, баллы за скидки, реклама, налог, себестоимость), остатки по кластерам, возвраты и утечки денег - то, что вручную приходится сводить из отчетов, как в разборе как посчитать прибыль на Ozon. Ключ хранится только на сервере. Для Ozon в кабинете действует бесплатный демо-доступ 14 дней с подключения магазина, регистрация без карты.
Менять что-то в кабинете Ozon (цены, акции, ответы на отзывы, заявки на поставку) по ключу на чтение нельзя. Для этого нужен отдельный ключ с правом изменений, и его можно не давать вовсе.
Частые ошибки при подключении API Ozon
- «Ключ не принят». Скопирован не целиком, с пробелом или истек срок. Выпустите новый и вставьте без лишних символов.
- Перепутаны идентификаторы. В поле для ключа магазина вставлен номер рекламного кабинета или наоборот.
- У роли нет нужных методов. Сервис просит финансы, а ключ выпущен с узкой ролью. Проверьте роль и выпустите ключ с нужной.
- Ошибка 429. Программа шлет запросы чаще лимита. Помогают пауза и повтор, а не новый ключ.
- Старая версия метода. Своя выгрузка вдруг перестала работать - проверьте, не отключил ли Ozon версию метода, на которой она написана.
- Полные права «на всякий случай». Это не ошибка подключения, а самый дорогой риск: такой ключ может менять цены и карточки.
API Ozon и токен Wildberries: что отличается
Логика одна: доступ для программ без пароля от кабинета, права выбираете вы. Отличия в деталях: у Ozon пара Client ID и ключ с ролью, у WB - один токен с категориями доступа и галочкой «Только на чтение». Рекламу Ozon вынес в отдельный API, у WB продвижение - категория того же токена. Как выпустить токен WB, описано в инструкции токен WB: как создать и подключить.