Что это
Партнерский API Яндекс Маркета нужен продавцу для обмена данными между Маркетом и своими системами. Состав методов зависит от задачи, модели работы магазина и разрешений токена. Кабинет и отдельный магазин имеют разные идентификаторы.
Это не самостоятельный ИИ-агент продавца. API дает сведения и операции; расчет, генерацию текста и решение об изменении цены выполняет отдельный процесс. Для записи нужны проверяемые правила и подтверждение ответственного.
Первый полезный результат - получить список своих магазинов и проверить их доступность для API. Это не меняет цены или заказы. После проверки подключения добавляйте только тот ресурс, который нужен вашему отчету.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Структурированные методы позволяют автоматизировать обмен с кабинетом продавца.
- API-Key можно ограничить группами методов и доступом на чтение.
- Список магазинов дает ID кабинета, магазина и модель размещения.
- OpenAPI-спецификация помогает создавать клиент интеграции.
Ограничения
- Методы требуют подходящих прав токена и доступного кабинета.
- У разных методов собственные лимиты и правила пагинации.
- Старые page/pageSize нельзя переносить в новый сценарий списка магазинов.
- ИИ-анализ и контроль записи не входят в простое подключение API.
Как использовать
1. Подготовка. Получите разрешение владельца кабинета Маркета и запишите ожидаемый магазин и модель размещения. Выберите тест списка магазинов без чтения покупателей и изменения заказов.
2. Настройка. В кабинете откройте Настройки > API и модули, создайте отдельный API-Key с подходящим правом чтения, например offers-and-cards-management:read-only для getCampaigns. Сохраните токен в защищенных настройках сервера; передавайте его заголовком Api-Key: <токен>, без Bearer.
3. Первый результат. Выполните GET https://api.partner.market.yandex.ru/v2/campaigns?limit=2. Из campaigns прочитайте domain, id, business.id, business.name, placementType и apiAvailability. Получите короткую карту магазинов и их кабинетов.
4. Проверка. Сверьте названия и идентификаторы с разделом API кабинета; campaign ID не равен рекламной кампании. Если есть paging.nextPageToken, передайте его как pageToken вместе с limit. page/pageSize помечены как отключаемые с 05.10.2026. Пустой список, 401/403 и apiAvailability с причиной блокировки - разные ситуации, не объединяйте их в «заказов нет».
Примеры сценариев
- Сверить магазин до подключения учетной системы.
- Обнаружить недоступный API и причину блокировки.
- Подготовить данные ассортимента для проверяемой сводки.
Доступ и оплата
- Модель оплаты: Не уточнено
- Работа в РФ: Да
- VPN: Не нужен
- Русский интерфейс: Да
- Русский язык: Не известно
Доступ связан с кабинетом, договором и состоянием размещения на Маркете. Стоимость услуг продавца, обслуживание интеграции и внешняя модель отдельные. Не называйте весь рабочий процесс бесплатным из-за наличия API-Key. Конкретные расходы проверяйте в своем договоре и кабинете.
Когда не подходит
- Получить данные всех продавцов Маркета
- Автоматически менять цены по непроверенному прогнозу
- Считать идентификатор кабинета ID отдельного магазина
Альтернативы
Ozon Seller API и Wildberries API относятся к другим маркетплейсам. retailCRM API может участвовать в обработке заказов и связях с CRM, но не заменяет права кабинета Маркета.
