API документация · /yandex/merchants-marketplaces · 2 документа

API индекса цен: Цены товаров на маркетплейсах

Получите список минимальных цен на товары вашего магазина на маркетплейсах. В опубликованном контракте поддерживается Ozon и регион Москва. Сохранены требования к правам на домен, параметры пагинации и ответы API.

Паспорт источника

Service ID
/yandex/merchants-marketplaces
Источник
yandex.ru — официальная документация
Документов
2
Состав
1 метод · 1 руководство · 2 страницы
Проверка источника
03.11.2026
Версия API
не подтверждена
yandex.ru/support/merchants/ru/api-marketplaces/

Что включено

2 документа API индекса цен в одном поиске

Сохранённые копии yandex.ru. У каждого документа — ссылка на официальную страницу и дата импорта.

  • Минимальные цены

    1

    Получение офферов, фильтрация по домену и магазину, курсорная пагинация, поля ответа и ошибки.

    • minPrice
    • nextCursor
  • Доступ и ограничения

    1

    OAuth с доступом merchants:marketplaces и подтверждение прав на домен в Вебмастере. Ozon, Москва, без гарантии совпадения с текущими ценами.

    • Authorization: OAuth
    • merchants:marketplaces

Документация

Частые задачи: методы и руководства

Название ведёт на документ в поиске Bridge8, стрелка — на официальную страницу yandex.ru.

Как использовать

Три способа работать с документацией API индекса цен

Без регистрации — на сайте. С регистрацией — через MCP-сервер прямо в Claude Code, Cursor или своём агенте.

  1. 01 · На сайте

    Поиск без регистрации

    Выберите API индекса цен в поиске и введите метод или задачу. Результаты — только из этого источника, со ссылкой на yandex.ru.

    API индекса цен · 2 → minPrice
  2. 02 · ИИ-агент по MCP

    Спросите Claude Code или Cursor

    Агент сам находит сервис, ищет фрагменты и читает документ целиком. В ответе — ссылка на источник и дата импорта.

    «Найди API merchants:marketplaces. Какие цены он возвращает, как передать domain и clientId, получить следующую страницу и обработать ошибки доступа?»
    resolve_service → search_docs → get_document

  3. 03 · Документ целиком

    Читайте страницу полностью

    get_document отдаёт документ постранично: параметры, поля, примеры. Удобно, когда агенту нужна вся страница, а не фрагмент.

    get_document → Список минимальных цен

Пример ответа · GET /api/v3/marketplaces/offers/list

API индекса цен /yandex/merchants-marketplaces

GET /api/v3/marketplaces/offers/list

Обязательный domain задаёт магазин и проверку прав. clientId ограничивает выборку магазином маркетплейса; cursor продолжает ту же выборку.

Параметры

domainstring
Обязательный домен магазина.
clientIdstring
Необязательный идентификатор магазина.
limitint32
От 0 до 100, по умолчанию 100.
yandex.ru/support/merchants/ru/api-marketplaces/offers-list

версия не подтверждена

Подключение

Подключите документацию API индекса цен к ИИ-агенту

Один MCP-сервер Bridge8 — и агент знает API индекса цен и ещё 22 API: VK, Яндекс Директ, Битрикс24, Авито и другие. Доступ бесплатный, вход по коду из письма — без пароля.

Как подключить за минуту

  1. Получите токенВойдите в личный кабинет по почте и создайте Bearer-токен.
  2. Добавьте серверАдрес https://bridge8.ru/mcp, транспорт Streamable HTTP. В совместимых клиентах можно войти через OAuth.
  3. Спросите про API индекса ценНайди API индекса цен Яндекс Товаров и объясни minPrice, ограничения и пагинацию.
Только документация

Bridge8 предоставляет документацию. Данные о ценах запрашиваются у API Яндекса с токеном пользователя.

Claude Code — команда
claude mcp add --transport http bridge8 \ https://bridge8.ru/mcp \ --header "Authorization: Bearer <TOKEN>"
JSON для --mcp-config
{ "mcpServers": { "bridge8": { "type": "http", "url": "https://bridge8.ru/mcp", "headers": { "Authorization": "Bearer <TOKEN>" } } } }

Инструменты сервера — в порядке вызова

  1. resolve_serviceНаходит сервис и версию по названию: «VK API», «Директ», «Битрикс24».
  2. search_docsИщет фрагменты внутри выбранного сервиса — до 10 за запрос.
  3. get_documentЧитает документ целиком, постранично, со ссылкой на источник.

Вопросы

Вопросы о API индекса цен

Какие маркетплейсы и регионы поддерживаются?

Официальная документация указывает только Ozon и регион Москва. Совпадение возвращаемых цен с фактическими на момент запроса не гарантируется.

Какой доступ нужен?

OAuth-токен должен иметь merchants:marketplaces. Пользователь должен подтвердить права на домен в Яндекс Вебмастере. Токен передаётся как Authorization: OAuth <token>.

Как читать следующую страницу?

Передайте nextCursor из ответа как cursor следующего запроса с теми же domain и clientId. Если nextCursor равен null, следующей страницы нет. Офферы отсортированы по url.

Чем отличаются ошибки 403?

INSUFFICIENT_SCOPE означает отсутствие merchants:marketplaces в токене. PERMISSION_DENIED означает, что пользователь не подтвердил права на домен.

Ещё в Bridge8

Один поиск и один MCP-сервер для 23 API, справки и курсов. Сервисы и версии ищутся раздельно и не смешиваются.

Нет нужного API?

Добавим документацию вашего API в Bridge8

Напишите, какой API нужен вам или вашим клиентам, и пришлите ссылку на официальную документацию. Мы проверим источник и подключим его к поиску, каталогу и MCP-серверу — со ссылкой на первоисточник у каждого ответа.

info@lidfly.rugithub.com/awaik/bridge8

Что прислать

  1. Ссылку на документациюОфициальный сайт, OpenAPI/Swagger или репозиторий с описанием методов.
  2. Название и версию APIНапример, «Ozon Seller API». Версии ищутся отдельно и не смешиваются.
  3. Для чего он нуженИнтеграция, ИИ-агент, поддержка клиентов — так мы поймём приоритет.