Справочник/Ozon Seller API

Ограничения Ozon Seller API, о которых не пишут в документации

Проверено · Markdown-версия
Коротко

Кроме общего лимита частоты (ответ 429) у отдельных методов Ozon есть свои ограничения: из архива возвращается около 100 товаров в сутки на магазин, отчет о выкупе после одного запроса недоступен больше 6 минут, начисления запрашиваются по одной дате, синхронная статистика рекламы - не больше 62 дней за запрос. В таблице у каждого ограничения указана дата проверки.

Таблица ограничений

МетодОграничениеКак обойтиПроверено
/v1/product/unarchiveоколо 100 товаров в сутки на магазин; при превышении ответ с текстом restore limit exceeded, граница суток лимита не совпала с полуночью по Москвеочередь: при ответе со словом limit повторять через 10-15 минут, а не помечать товары ошибочными23.09.2026
/v1/product/archiveсуточного лимита не наблюдалось-11.09.2026
/v1/finance/products/buyoutпосле одного запроса 429 дольше 6 минут; у части магазинов 403 при рабочем ключеодин запрос на период за прогон; ключ проверять другим методом07.10.2026
/v1/finance/accrual/by-dayодна дата за запрос, постраничность через last_idцикл по дням; последние 1-2 недели перезагружать: логистика начисляется с задержкой02.08.2026
/v1/product/rating-by-skuне больше 100 SKU, на 101 ответ 400 too many skus: limit=100; SKU передаются строками; подписка Premium не нужнапачки по 10027.09.2026
/v2/product/info/stocks-by-warehouse/fbsнужен список offer_id или sku; ответ по каждой паре товар-склад, включая нули; версия v1 отвечает obsolete method cannot be usedпачки по 100 offer_id10.08.2026
/v2/analytics/stock_on_warehousesостатки FBO по складам без ID склада, только названиесопоставлять склад по названию10.08.2026
/v1/analytics/dataметрики просмотров и добавлений в корзину не возвращаются; устаревшие метрики отбрасываются без ошибки-18.08.2026
/v1/analytics/product-queriesпоисковые запросы по товару без подписки Premium недоступны: PermissionDenied за любой период-13.07.2026
Performance API /api/client/statisticsдо 10 кампаний в отчете, один отчет на кабинет за разочередь отчетов, ожидание готовности до 10 минут01.10.2026
Performance API statistics/daily/json, expense/jsonне больше 62 дней за запросзапрашивать кусками по 60 дней01.10.2026

Общие правила

  • На 429 повторяйте запрос с растущей паузой и случайным разбросом, а не сразу.
  • Отличайте "метод недоступен магазину" от "ключ отозван": на 403 одного метода проверьте ключ простым запросом списка товаров, прежде чем отключать интеграцию.
  • Ответ {"result": true} у методов архива значит, что запрос принят, а не что каждый товар обработан. Фактический статус проверяйте через /v3/product/info/list: списки по фильтру архива обновляются с задержкой.
  • offer_id Ozon различает с учетом регистра, подробнее - в ответе про идентификаторы товара.
Дата в таблице - когда ограничение проверено живым запросом. Ozon меняет ограничения без анонса. Если ваше наблюдение расходится с таблицей, напишите нам через контакты.
Эти цифры по вашему магазину

MP Index считает комиссии, логистику и прибыль каждого товара по начислениям вашего Ozon Seller API.

Открыть демо →