для разработчиков

Асинхронный клиент для Ozon

• полная типизация: msgspec-модели
• повторы с экспоненциальной задержкой
• четыре схемы пагинации (cursor, last_id, offset, page)

Поддерживаются сейчас:

  Seller API 2.1 — Для работы с продажами

  Performance API 2.0 — Для работы с рекламным кабинетом

  FBP API 1.2.1 — Для работы с партнерскими складами Ozon

  ОРД API 1.0.0 — Для обмена данными поставщика и Ozon

  API партнёра 1.1 — Для отправки писем и СМС

  Delivery API — Для отправки заказов клиентам

  Flex API 1.1.0 — Для обмена данными в системе Flex

  Logistic Platform API 2.0.0 — Для интеграции 3PL

  Retail API 1.0.0 — Для автоматизации работы поставщика

  Statistics API 2.1 — Для аналитики продаж

  Applications API 1.0.0 — Для интеграции в Магазин приложений

  Export API Logistic Platform 1.0.0 — Для экспортной логистики

Установка

pip install ozon-sdk

Как получить API-ключ

Не передавайте API-ключ посторонним людям

Запросы к API изменяют данные в вашем магазине на Ozon. Если доступ к ключу будет у посторонних, они смогут управлять вашим магазином.

Чтобы получить API-ключ:

1. В личном кабинете перейдите в Настройки → Seller API.
   
   
2. Нажмите Сгенерировать ключ.
   
   
3. Придумайте название для ключа и выберите его уровень доступа.
   
   
4. Выберите цель использования ключа:

• для личного пользования;
• для внешнего сервиса, приложения — введите название сервиса, для которого выпускается ключ.
  
  

5. Нажмите Сгенерировать.

Срок действия ключа — 3 месяца. После истечения срока действия сгенерируйте новый ключ в личном кабинете.

Seller API

Ozon Seller API — программный интерфейс для работы с маркетплейсом Ozon. Он даёт возможность обмениваться информацией между системой продавца и Ozon.

Методы Seller API позволяют изменять данные магазина, например, остатки товаров или их стоимость, и получать данные, такие как информация о возвратах или список складов.

Работа с API состоит из отправки запроса и получения ответа. Для этого можно использовать вкладку Консоль, которая находится сверху описания методов, Postman или настроить интеграцию с системами учёта, например, 1С, ERP или МойСклад.

Получить список отправлений в отгрузке

import asyncio

from ozon_sdk import SellerAPI


async def main() -> None:
    async with SellerAPI(
        client_id="123456",
        api_key="b1u5XXDQW3wEqQ7dG...ancMyuhQtMNBI",
    ) as api:
        response = await api.assembly_carriage_posting_list(limit=100)
        for posting in response.postings or []:
            print(posting.posting_number)


asyncio.run(main())

Получить аналитику по остаткам

import asyncio

from ozon_sdk import SellerAPI


async def main() -> None:
    async with SellerAPI(
        client_id="123456",
        api_key="b1u5XXDQW3wEqQ7dG...ancMyuhQtMNBI",
    ) as api:
        response = await api.analytics_stocks(skus=["sku"])
        for item in response.items or []:
            print(item.offer_id)


asyncio.run(main())

Получить информацию о товарах по идентификаторам

import asyncio

from ozon_sdk import SellerAPI


async def main() -> None:
    async with SellerAPI(
        client_id="123456",
        api_key="b1u5XXDQW3wEqQ7dG...ancMyuhQtMNBI",
    ) as api:
        response = await api.get_product_info_list(offer_id=["offerId"])
        for product in response.items or []:
            print(product.name)


asyncio.run(main())

Информация о количестве товаров

import asyncio

from ozon_sdk import SellerAPI


async def main() -> None:
    async with SellerAPI(
        client_id="123456",
        api_key="b1u5XXDQW3wEqQ7dG...ancMyuhQtMNBI",
    ) as api:
        response = await api.get_product_info_stocks(limit=100)
        for product in response.items or []:
            print(product.offer_id)


asyncio.run(main())

Performance API

Ozon Performance API — интерфейс для работы с рекламным кабинетом для обмена информацией между системой продавца и Ozon.

Список кампаний

import asyncio

from ozon_sdk import PerformanceAPI


async def main() -> None:
    async with PerformanceAPI(
        client_id="123456",
        client_secret="b1u5XXDQW3wEqQ7dG...ancMyuhQtMNBI",
    ) as api:
        response = await api.campaign.list_campaigns(adv_object_type="SKU")
        for campaign in response.list_ or []:
            print(campaign.title)


asyncio.run(main())

Список товаров кампании

import asyncio

from ozon_sdk import PerformanceAPI


async def main() -> None:
    async with PerformanceAPI(
        client_id="123456",
        client_secret="b1u5XXDQW3wEqQ7dG...ancMyuhQtMNBI",
    ) as api:
        response = await api.product.get_products_v2(campaign_id="campaignId", page_size=100)
        for product in response.products or []:
            print(product.sku)


asyncio.run(main())

Лимиты ставок для инструментов продвижения

import asyncio

from ozon_sdk import PerformanceAPI


async def main() -> None:
    async with PerformanceAPI(
        client_id="123456",
        client_secret="b1u5XXDQW3wEqQ7dG...ancMyuhQtMNBI",
    ) as api:
        response = await api.campaign.get_limits_list()
        for limit in response.limits or []:
            print(limit.object_type, limit.min_bid, limit.max_bid)


asyncio.run(main())

Дневная статистика по кампаниям

import asyncio

from ozon_sdk import PerformanceAPI


async def main() -> None:
    async with PerformanceAPI(
        client_id="123456",
        client_secret="b1u5XXDQW3wEqQ7dG...ancMyuhQtMNBI",
    ) as api:
        response = await api.statistics.get_campaign_daily_stats(
            campaign_ids=["campaignId"],
            date_from="2026-09-01",
            date_to="2026-09-16",
        )
        print(response.content_type)


asyncio.run(main())

FBP API

Ozon FBP API — интерфейс для работы со схемой Fulfillment by Partner: поставками, отгрузками и остатками на складе партнёра.

import asyncio

from ozon_sdk import FbpAPI


async def main() -> None:
    async with FbpAPI(
        client_id="123456",
        client_secret="b1u5XXDQW3wEqQ7dG...ancMyuhQtMNBI",
        api_key="b1u5XXDQW3wEqQ7dG...ancMyuhQtMNBI",
    ) as api:
        response = await api.seller_info()
        print(response)


asyncio.run(main())

ОРД API

Ozon ОРД API — интерфейс для маркировки рекламы: договоры, креативы, акты и справочники ЕРИР.

import asyncio

from ozon_sdk import OrdAPI


async def main() -> None:
    async with OrdAPI(api_key="b1u5XXDQW3wEqQ7dG...ancMyuhQtMNBI") as api:
        response = await api.get_kktu_dict()
        for item in response:
            print(item)


asyncio.run(main())

Comms API

Ozon Comms API — интерфейс для отправки писем и СМС покупателям и партнёрам.

import asyncio

from ozon_sdk import CommsAPI


async def main() -> None:
    async with CommsAPI(
        app_name="partner_name",
        username="user",
        password="pass",
    ) as api:
        response = await api.sms_send(
            comm_id=1,
            phone="+79250240477",
            source_event_name="partner_name",
        )
        print(response)


asyncio.run(main())

Ozon Delivery API

Ozon Delivery API — интерфейс для интеграции логистики Ozon: методы доставки, заказы, отправления и возвраты.

import asyncio

from ozon_sdk import OzonDeliveryAPI


async def main() -> None:
    async with OzonDeliveryAPI(
        client_id="123456",
        client_secret="b1u5XXDQW3wEqQ7dG...ancMyuhQtMNBI",
    ) as api:
        response = await api.shipment_method_search()
        print(response)


asyncio.run(main())

Flex API

Flex API — интерфейс для обмена данными с партнёрами в системе Flex: заявки на подключение курьеров и их балансы.

import asyncio

from ozon_sdk import FlexAPI


async def main() -> None:
    async with FlexAPI(
        client_id="123456",
        api_key="b1u5XXDQW3wEqQ7dG...ancMyuhQtMNBI",
    ) as api:
        response = await api.get_info()
        print(response)


asyncio.run(main())

Logistic Platform API

Ozon Logistic Platform API — интерфейс для 3PL-провайдеров логистики: заказы, отгрузки, маршруты и пункты выдачи.

import asyncio

from ozon_sdk import LogisticPlatformAPI


async def main() -> None:
    async with LogisticPlatformAPI(
        client_id="123456",
        client_secret="b1u5XXDQW3wEqQ7dG...ancMyuhQtMNBI",
    ) as api:
        response = await api.get_points()
        print(response)


asyncio.run(main())

Retail API

Ozon Retail API — интерфейс для работы с Retail Center: заказы на поставку, склады, грузоместа и пропуска.

import asyncio

from ozon_sdk import RetailAPI


async def main() -> None:
    async with RetailAPI(
        client_id="123456",
        client_secret="b1u5XXDQW3wEqQ7dG...ancMyuhQtMNBI",
    ) as api:
        response = await api.warehouses()
        for warehouse in response:
            print(warehouse)


asyncio.run(main())

Statistics API

Ozon Statistics API — интерфейс для получения данных по продажам: остатки, рейтинг и отзывы магазина.

import asyncio

from ozon_sdk import StatisticsAPI


async def main() -> None:
    async with StatisticsAPI(
        client_id="12345",
        access_key="0dc8194a-be47-4983-b82b-c7fdb62ac692",
    ) as api:
        response = await api.product_reviews(sku="123456789")
        print(response)


asyncio.run(main())

Applications API

Ozon Applications API — интерфейс для приложений в магазине Ozon: OAuth-авторизация продавца и платежи.

import asyncio

from ozon_sdk import ApplicationsAPI


async def main() -> None:
    async with ApplicationsAPI(
        client_id="123456",
        client_secret="b1u5XXDQW3wEqQ7dG...ancMyuhQtMNBI",
    ) as api:
        response = await api.get_me()
        print(response)


asyncio.run(main())

Export API Logistic Platform

Export API Logistic Platform — интерфейс для экспортного потока логистической платформы Ozon: посылки, маршруты и документы.

import asyncio

from ozon_sdk import ExportLogisticPlatformAPI


async def main() -> None:
    async with ExportLogisticPlatformAPI(
        client_id="123456",
        client_secret="b1u5XXDQW3wEqQ7dG...ancMyuhQtMNBI",
    ) as api:
        response = await api.get_points()
        print(response)


asyncio.run(main())

Лицензия

MIT