Wildberries API: Выгрузить все карточки товаров

Сценарий из mcp-everything. Актуально на 2026-10-24.

Получить список своих товаров с артикулами WB, артикулами продавца и размерами — для сопоставления с учётной системой.

  1. Нужен токен с категорией «Контент», хост https://content-api.wildberries.ru. Лимит — 100 запросов в минуту на все методы категории.
  2. Запроси первую страницу: POST /content/v2/get/cards/list с settings.cursor.limit = 100 и settings.filter.withPhoto = -1 (все карточки).
  3. Для следующей страницы скопируй из ответа cursor.updatedAt и cursor.nmID в settings.cursor запроса.
  4. Повторяй, пока cursor.total не станет меньше limit — значит, получены все карточки.
  5. Из каждой карточки сохрани nmID, vendorCode и sizes[].chrtID — по chrtID обновляются остатки.
curl -X POST https://content-api.wildberries.ru/content/v2/get/cards/list \
  -H "Authorization: $WB_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"settings": {"cursor": {"limit": 100}, "filter": {"withPhoto": -1}}}'

# Следующая страница — с курсором из предыдущего ответа
curl -X POST https://content-api.wildberries.ru/content/v2/get/cards/list \
  -H "Authorization: $WB_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"settings": {"cursor": {"limit": 100, "updatedAt": "2023-12-06T11:17:00.96577Z", "nmID": 123654123}, "filter": {"withPhoto": -1}}}'

Базовые URL

Авторизация

Тип: API-ключ

Токен создаётся в кабинете продавца: «Настройки» → «Доступ к API» → выбрать категории → «Создать токен». Сохраните его сразу — повторно посмотреть нельзя. Токен — JWT, действует 180 дней. Передаётся в заголовке Authorization.

Типы токенов: стандартный (полный доступ к выбранным категориям), тестовый (работает только в песочнице) и «только на чтение». Категория токена должна совпадать с категорией вызываемого API, иначе будет 401.

Проверить доступ можно методом /ping на хосте категории, например https://content-api.wildberries.ru/ping. Ответ:

{"TS": "...", "Status": "OK"}

Методы сценария

POST /content/v2/get/cards/list — Список карточек товаров

Хост «Контент». Возвращает созданные карточки с курсорной пагинацией.

Параметр Где Тип Обяз. Описание
locale query string нет Язык
settings body object да Настройки выборки
settings.cursor.limit body integer нет Количество карточек на странице
settings.filter.withPhoto body integer нет Фильтр по наличию фото; -1 — все

Пример запроса:

{
  "settings": {
    "cursor": {
      "limit": 100
    },
    "filter": {
      "withPhoto": -1
    }
  }
}

Нюансы

Другие сценарии

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