Яндекс Маркет Partner API: POST /v2/businesses/{businessId}/offer-mappings — Информация о товарах в каталоге

Список товаров, их категории на Маркете и характеристики.

Параметр	Где	Тип	Обяз.	Описание
businessId	path	integer	да	Идентификатор кабинета
pageToken	query	string	нет	Страница результатов
limit	query	integer	нет	Количество значений на странице
language	query	string	нет	Язык name и description, по умолчанию RU
offerIds	body	array	нет	SKU товаров
cardStatuses	body	array	нет	Статусы карточек
categoryIds	body	array	нет	Категории на Маркете
vendorNames	body	array	нет	Бренды
tags	body	array	нет	Теги
archived	body	boolean	нет	true — товары в архиве

Базовые URL

• Боевой: https://api.partner.market.yandex.ru

Авторизация

Тип: API-ключ

Основной способ — API-ключ (Api-Key-токен) из кабинета продавца в заголовке Api-Key. Также поддерживается OAuth-токен Яндекса со скоупом market:partner-api (авторизация через https://oauth.yandex.ru/authorize). Доступ к методам определяется доступами токена: all-methods, all-methods:read-only, inventory-and-order-processing, offers-and-cards-management, pricing, communication, finance-and-accounting, settings-management, promotion и их read-only вариантами.

curl https://api.partner.market.yandex.ru/v2/campaigns -H "Api-Key: <token>"

Нюансы

• Пагинация — по pageToken и limit; параметры page и pageSize устарели и отключаются с 05.10.2026.
• GET /v2/campaigns/{campaignId}/orders отключается 12.04.2027 — переходите на POST /v1/businesses/{businessId}/orders.
• Параметры offer.category, offer.params, customsCommodityCode устарели (отключение 12.10.2026); используйте marketCategoryId, parameterValues, commodityCodes.
• При ошибке хотя бы в одном товаре offer-mappings/update не отправляет в каталог ни один товар из запроса; ответ 200 сам по себе не означает, что товары прошли проверку.
• Отчёты генерируются асинхронно: сначала .../generate, потом опрос GET /v2/reports/info/{reportId}.
• Тестовые заказы отмечены fake: true.
• У метода GET /v2/campaigns/{campaignId}/orders ограничение — до 6 параллельных запросов.

Сценарии с этим методом

• Добавить товар в каталог

---

Если этого недостаточно — официальная документация: https://yandex.ru/dev/market/partner-api/doc/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/yandex-market.md