API списка товаров v1

Доступ и лимиты

Базовый адрес: https://probiwaem.ru/api/v1. Ключ доступен при активном PRO. Передавайте Authorization: Bearer pbk_… или X-API-Key: pbk_…. Ключ показывается один раз при создании; отозвать его можно в кабинете. Храните его на своём сервере.

На каждый ключ: 60 запросов в минуту и 1 000 в сутки, по UTC. В PRO — до 100 товаров в списке, 30 ссылок в одном импорте и 2 незавершённых задания на аккаунт. Запросы статуса тоже входят в лимит. При HTTP 429 подождите число секунд из Retry-After.

Актуальные возможности: GET /capabilities. Машиночитаемая схема: OpenAPI. Список и задания всегда принадлежат владельцу ключа.

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

Проверки возвращают data_source: server — карточку и отзывы получил сервер; browser — данные прислал браузер; unknown — источник старой записи не установлен.

Результат browser доступен в текущем ответе: он не публикуется, не обновляет общие цены и вердикты, не сохраняется в историю. Поля analysis_id и short_id пустые, saved_to_history=false. Успешные проверки учитываются в квоте. Совпадение артикула и ссылки не подтверждает подлинность отзывов.

Методы

Импорт и повторы

curl https://probiwaem.ru/api/v1/monitoring/imports \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: seller-batch-2026-10-04-01' \
  -d '{"items":[{"url":"https://www.wildberries.ru/catalog/123456/detail.aspx","role":"competitor","group_name":"Кофемолки"}]}'

Роли: own — свой товар, competitor — конкурент, watch — наблюдение для покупки. Группа — до 80 символов. Один товар нельзя повторять в одном задании.

Ключ повтора: 8–128 букв, цифр или символов ._:-. При потере ответа повторите тот же запрос с тем же ключом. Сервер вернёт существующее задание (HTTP 200); другой список с этим ключом получит HTTP 409. Новый ключ создаёт новое задание. Ключи сохраняются вместе с заданиями.

Существующий разбор используется повторно. Новый анализ WB расходует обычную квоту аккаунта. Для других площадок сначала проверьте карточку расширением. completed означает окончание обработки: отдельные товары могут иметь status=error. При таймауте анализа или import_interrupted проверьте историю перед новым импортом: анализ мог уже выполниться.

Правило цены

PATCH /api/v1/monitoring/products/42
{"target_price_kopecks":149900,"notify_on_burst":true}

Цена задаётся целым числом копеек. null удаляет целевую цену. Уведомление срабатывает при достижении порога; доставка использует включённые каналы аккаунта. После смены порога подходящий следующий замер может вызвать уведомление.

price_observation.status: fresh — успешный сбор не старше суток, stale — старше суток, pending — замеров нет, unavailable — последняя попытка неудачна, paused — наблюдение на паузе. Дата успешного сбора и дата попытки выдаются отдельно. Не подставляйте отсутствующую цену как ноль.

Автоматический сбор цен WB зависит от доступности площадки. Для остальных площадок используются уже полученные данные. Сервис показывает добавленные товары и проверенную выборку отзывов; полный каталог, продажи и остатки продавца этим API не предоставляются.

План действий по отзывам

POST /api/v1/reviews/workbench разбирает отзывы из вашей выгрузки. Название площадки произвольное, подключение магазина не требуется. Cookie входа подходит для бесплатного разбора на сайте; API-ключ использует обычный доступ PRO.

{"reviews":[{"product_id":"SKU-1","product_name":"Кофемолка","marketplace":"Ozon","rating":2,"text":"Перестала работать через неделю"}]}

Максимум 1 000 отзывов, 100 товаров, 4 000 символов в тексте и 1 100 000 байт в теле запроса. Оценка — целое число 1–5. Группы разделяются по площадке и product_id. Лимит на аккаунт: 5 запросов в минуту и 50 в сутки; при недоступности контроля лимитов возвращается 503.

В ответе source=private_import, persisted=false и products[].insights: найденные темы, число разных текстов, по два примера и действия для продавца и покупателя. Разбор использует русскоязычные фразы в отзывах с оценками 1–3; дубли исключаются. Один отзыв может относиться к нескольким темам. Это не статистика возвратов или брака.

Данные не добавляются в публичные проверки, мониторинг или общий кеш. Не передавайте контакты покупателей. Отправка не расходует проверки и не вызывает платный анализ. Готовые проверки товаров отдельно могут содержать review_insights с source=server_sample; прошлые проверки без таких данных возвращают null.

Ошибки и диагностика

{"error":{"code":"api_key_rate_limited","message":"Лимит запросов API исчерпан.","retryable":true,"request_id":"example-123","details":{}}}

HTTP 401 — ключ недействителен; 402 — нужен PRO или исчерпана квота; 403 — доступ запрещён; 404 — объект отсутствует в вашем аккаунте; 409 — конфликт ключа импорта или заполненный список; 422 — неверные параметры; 429 — лимит запросов или очередь; 500 — ошибка сервиса; 503 — временно недоступна зависимость, например контроль лимитов. При 503 учитывайте Retry-After, если он передан.

В ответах передаётся X-Request-ID. Можно задать свой (до 64 букв, цифр, точек, дефисов или подчёркиваний) и передать его поддержке. Для HTTP 429 и ошибок сервера допустим повтор с задержкой; POST импорта повторяйте с исходным ключом и телом.