Инструкция · Ozon API

API ключ Ozon Seller: как получить Client ID и API Key и подключить интеграцию

26 апреля 2026

10 минут чтения

API ключ Ozon Seller — это два параметра: Client ID и API Key. Вместе они открывают доступ к данным вашего магазина на Ozon: заказам FBO и FBS, товарам, ценам, остаткам, аналитике и отчётам. В этой статье разберём, где найти ключи в кабинете, как они работают, в чём разница между Seller API и Performance API, и как использовать Ozon API без единой строки кода.

Что такое Ozon Seller API и какие возможности открывает

Ozon Seller API — это официальный программный интерфейс маркетплейса для автоматизации работы с магазином. Через API можно получать и обновлять практически любые данные, доступные в личном кабинете seller.ozon.ru.

Основные возможности Ozon Seller API:

Заказы. Получать список заказов FBO и FBS, менять статусы, подтверждать отгрузку, печатать ярлыки.
Товары. Создавать и обновлять карточки товаров, загружать фото, управлять контентом.
Цены. Массово обновлять цены, устанавливать акционные скидки, управлять ценовыми стратегиями.
Остатки. Обновлять остатки FBS, получать данные по остаткам на складах Ozon FBO.
Аналитика и отчёты. Выгружать финансовые отчёты, аналитику по товарам, данные о транзакциях.
Поставки. Управлять поставками FBO: создавать, отслеживать статусы.

Важно: Ozon API разделён на два независимых интерфейса — Seller API и Performance API. У каждого свои ключи авторизации. Не путайте их при настройке интеграций.

Как получить API ключ Ozon: Client ID и API Key — пошаговая инструкция

Для работы с Ozon Seller API нужны два параметра: числовой Client ID (идентификатор вашего аккаунта) и API Key (секретный токен). Оба находятся в одном разделе личного кабинета.

Войдите в личный кабинет Ozon Seller

Откройте seller.ozon.ru и авторизуйтесь. Вам нужен аккаунт продавца — доступ к API есть только у верифицированных магазинов.

Перейдите в «Настройки» → «API ключи»

В левом боковом меню найдите раздел «Настройки» (иконка шестерёнки), затем выберите пункт «API ключи». Здесь отображается ваш Client ID и список созданных API ключей.

Скопируйте Client ID

Client ID отображается в верхней части страницы — это числовой идентификатор вашего аккаунта. Он постоянный и не меняется. Скопируйте его — он понадобится вместе с API Key.

Нажмите «Сгенерировать ключ»

Выберите тип ключа «Seller API» (не Performance). Задайте понятное название, например «EcomConnector» или «Google Таблицы». Нажмите «Сгенерировать».

Скопируйте и сохраните API Key

После генерации Ozon показывает API Key только один раз. Сразу скопируйте его и сохраните в надёжном месте. Если потеряете — придётся генерировать новый ключ и обновлять все интеграции.

Совет: для каждой интеграции или сервиса создавайте отдельный API Key. Так, если один ключ окажется под угрозой, вы сможете отозвать только его, не затрагивая остальные подключения.

Ozon Seller API vs Ozon Performance API: в чём разница

Многие продавцы путают два разных API Ozon. Вот ключевые отличия:

Параметр	Ozon Seller API	Ozon Performance API
Для чего	Управление магазином: заказы, товары, остатки, отчёты	Управление рекламными кампаниями
Где получить ключи	seller.ozon.ru → Настройки → API ключи	performance.ozon.ru → Настройки → API
Параметры авторизации	Client ID + API Key (в заголовках)	Client ID + Client Secret (OAuth 2.0)
Базовый хост	api-seller.ozon.ru	api-performance.ozon.ru
Данные о заказах	Да	Нет
Данные о рекламе	Нет	Да

Итог: для выгрузки заказов, товаров, цен, остатков и финансовых отчётов — нужен Ozon Seller API. Для статистики рекламных кампаний — Ozon Performance API. EcomConnector поддерживает оба.

Основные методы Ozon API: что можно получить

Заказы FBO и FBS

POST /v3/posting/fbs/list — список заказов FBS за период
POST /v2/posting/fbo/list — список заказов FBO
POST /v3/posting/fbs/get — детали конкретного заказа FBS
POST /v2/posting/fbo/get — детали заказа FBO

Товары и контент

POST /v2/product/list — список товаров с фильтрами
POST /v2/product/info/list — детали товаров (цены, остатки, статусы)
POST /v3/products/info/attributes — атрибуты и характеристики

Цены и остатки

POST /v4/product/info/prices — актуальные цены и скидки по товарам
POST /v2/product/info/stocks — остатки FBS и FBO по артикулам
POST /v1/analytics/stock_on_warehouses — остатки на складах Ozon

Аналитика и финансы

POST /v1/analytics/data — аналитика по товарам: показы, клики, продажи
POST /v3/finance/transaction/list — финансовые транзакции
POST /v1/report/products/create — создание отчёта по товарам
POST /v4/finance/cash-flow-statement/list — отчёт о движении денежных средств

Ошибки при работе с Ozon API и как их решить

Ошибка 403 Forbidden

Наиболее частая ошибка при первом подключении. Причины и решения:

Неверный Client ID или API Key. Проверьте, что скопировали оба значения без лишних пробелов.
Ключ отозван или пересоздан. Зайдите в кабинет Ozon и проверьте актуальный ключ.
Неправильные заголовки запроса. Ozon требует передавать Client-Id и Api-Key именно как заголовки HTTP-запроса, не в теле.
Неверный хост. Для Seller API используйте api-seller.ozon.ru, не другие домены.

Ошибка 429 Too Many Requests

Превышен лимит запросов. Базовые лимиты Ozon Seller API:

Большинство методов: до 600 запросов в час или 1 запрос/секунда
Методы аналитики и финансовых отчётов: более строгие лимиты
При ошибке 429 подождите и повторите запрос с экспоненциальной задержкой

Ошибка 400 Bad Request

Обычно означает неверный формат запроса. Проверьте формат дат (ISO 8601), обязательные поля и типы данных согласно документации api-seller.ozon.ru.

Совет: при работе с Ozon API используйте официальный Postman-сборник — он есть в документации Ozon. Это поможет быстро протестировать методы и убедиться в правильности ключей.

Как работать с Ozon API без написания кода — через EcomConnector

Понимание структуры Ozon API полезно, но большинству продавцов не нужно писать код. EcomConnector — это готовое расширение для Google Таблиц, которое уже реализует все основные методы Ozon Seller API и обновляет данные по расписанию.

Вы просто вводите Client ID и API Key Ozon — и выбираете, какие данные нужны. Без Python, без серверов, без поддержки кода при обновлении API.

Установите EcomConnector из Marketplace

Откройте Google Таблицу, перейдите в «Расширения» → «Дополнения» → «Установить дополнение». Найдите EcomConnector или перейдите по прямой ссылке.

Добавьте кабинет Ozon

В сайдбаре EcomConnector нажмите «Добавить кабинет» → «Ozon». Введите Client ID и API Key из раздела «Настройки» → «API ключи» вашего кабинета Ozon Seller.

Выберите отчёты

Отметьте нужные: заказы FBO, заказы FBS, товары, цены, остатки, аналитика, финансы. Для каждого отчёта можно задать свой интервал обновления.

Запустите выгрузку

Нажмите «Обновить» — данные появятся в вашей таблице по отдельным листам. Дальше EcomConnector обновляет их автоматически.

Что выгружает EcomConnector из Ozon API

Заказы FBO — каждый заказ отдельной строкой

Заказы FBS с деталями отгрузки

Остатки на складах Ozon (FBO)

Остатки FBS (ваш склад)

Товары и цены — текущие данные

Аналитика: показы, клики, продажи

Финансовые транзакции

Сравнение Ozon и WB в одной таблице

Ручная работа с Ozon API vs EcomConnector: сравнение

Параметр	Самостоятельная разработка	EcomConnector
Время до первых данных	Дни или недели разработки	5 минут
Нужен программист	Да (Python / Node.js / Apps Script)	Нет
Поддержка при обновлении Ozon API	Ваша ответственность	Автоматически
Обработка ошибок 429 и 403	Нужно реализовать самому	Встроена
Поддержка FBO и FBS	Нужно реализовать оба	Оба сразу
Поддержка WB + Ozon одновременно	Два отдельных проекта	В одном расширении
Расписание обновлений	Cron / триггеры / сервер	Встроено
Хранение данных	Ваша БД или сервер	В вашем Google Sheets

Подключите Ozon к Google Таблицам за 5 минут

Введите Client ID и API Key — и данные Ozon появятся в вашей таблице автоматически. Бесплатная установка.

Установить EcomConnector

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

Войдите в личный кабинет на seller.ozon.ru, перейдите в «Настройки» → «API ключи», нажмите «Сгенерировать ключ», выберите тип «Seller API» и скопируйте Client ID и API Key. Эти два значения нужны для авторизации.

Client ID и API Key находятся в разделе «Настройки» → «API ключи» личного кабинета seller.ozon.ru. Client ID — это числовой идентификатор вашего аккаунта, API Key — секретный токен.

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

Ошибка 403 означает отказ в авторизации. Проверьте правильность Client ID и API Key, убедитесь, что используете актуальный ключ, не истёкший и не отозванный. Также убедитесь, что запрос идёт на нужный хост (api-seller.ozon.ru).

Большинство методов Ozon Seller API имеют лимит 1 запрос в секунду или 600 запросов в час. Тяжёлые методы отчётности (аналитика, финансы) могут иметь более строгие ограничения. При превышении возвращается ошибка 429.

Для выгрузки заказов Ozon используется метод POST /v3/posting/fbs/list (для FBS) или /v2/posting/fbo/list (для FBO). Нужно передать Client ID и API Key в заголовках запроса. Альтернативно — используйте EcomConnector, который делает это без написания кода.

FBO API (Fulfillment by Ozon) — методы для управления остатками и заказами на складах Ozon. FBS API (Fulfillment by Seller) — методы для управления заказами, которые вы отгружаете сами. В Ozon Seller API есть отдельные эндпоинты для каждой схемы.

Установите EcomConnector из Google Workspace Marketplace. Введите Client ID и API Key Ozon — и выберите нужные отчёты. Заказы FBO/FBS, товары, цены, остатки, аналитика будут автоматически обновляться в вашей Google Таблице.