← MARPS Кабинет

MARPS Public API

REST API для интеграции с вашей CRM, BI или ERP. Получайте отзывы, товары, ответы и аналитику в JSON. Read-only, авторизация по API-ключу.

Базовые сведения

Базовый URL: https://marketplaces.marps.ru/api/v1/public/

Авторизация: заголовок Authorization: Bearer marps_live_... или X-API-Key: marps_live_...

Лимит: 60 запросов в минуту на каждый ключ. При превышении — 429 rate_limited.

Формат: JSON. Все timestamp'ы — ISO 8601 UTC.

Тариф: доступен на тарифе Бизнес и выше.

Авторизация

Ключ генерируется в кабинете: Настройки → API. Plaintext показывается один раз — сразу сохраните в безопасное место (например в Vault / 1Password). В БД MARPS хранится только хеш.

curl -H "Authorization: Bearer marps_live_a1b2c3d4..." \
     https://marketplaces.marps.ru/api/v1/public/reviews

Endpoints

GET/reviews

Список отзывов с пагинацией и фильтрами.

Query-параметры

Параметр	Тип	Описание
`page`	int	Номер страницы, дефолт 1
`pageSize`	int	Размер страницы 1-200, дефолт 50
`platform`	string	`wb` · `ozon` · `ya`
`rating`	int	1-5
`tone`	string	`positive` · `neutral` · `negative`
`status`	string	`sent` · `draft` · `pending`
`dateFrom`	ISO date	Отзывы опубликованные начиная с этой даты
`dateTo`	ISO date	До этой даты включительно

Пример

curl -H "Authorization: Bearer marps_live_..." \
     "https://marketplaces.marps.ru/api/v1/public/reviews?platform=ya&rating=5&pageSize=20"

Ответ

{
  "data": [
    {
      "id": "3e383a9d-d970-4405-8c9b-130f720bd110",
      "platform": "ya",
      "external_id": "437588322",
      "product_id": "ab12...",
      "author": "Анна",
      "rating": 5,
      "text": "Отличное качество, заказала ещё в подарок",
      "tone": "positive",
      "theme_ru": "Качество",
      "themes_multi": ["Quality", "Gift"],
      "photo_links": [],
      "external_url": "https://market.yandex.ru/product/...",
      "published_at": "2026-05-15T10:11:16.700Z",
      "response_status": "sent",
      "order_id": "57149419075",
      "paid_amount": 1922,
      "purchase_status": "purchased"
    }
  ],
  "meta": { "page": 1, "pageSize": 20, "total": 1788, "totalPages": 90 }
}

GET/reviews/{id}

Детали одного отзыва + связанный ответ если есть.

GET/products

Каталог товаров. Параметры: page, pageSize, platform, brand.

Ответ

{
  "data": [
    {
      "id": "...",
      "platform": "ya",
      "sku": "Strip_W-Gray_46",
      "name": "Рубашка женская в полоску хлопок",
      "brand": "Lady Gina",
      "category": "Рубашки длинные",
      "image_url": "https://...",
      "reviews_count": 412
    }
  ],
  "meta": { "page": 1, "pageSize": 50, "total": 1771 }
}

GET/responses

Отправленные/черновые ответы. Параметры: status, dateFrom, dateTo.

GET/analytics/summary

Агрегированные KPI за период. Параметр: periodDays (дефолт 30, макс 365).

Ответ

{
  "period_days": 30,
  "reviews": { "total": 642, "avg_rating": 4.3, "sent": 615, "pending": 12 },
  "tone": { "positive": 480, "neutral": 110, "negative": 52 },
  "purchase_status": { "purchased": 581, "refused": 8, "returned": 4 }
}

Ошибки

Код	error	Что значит
401	`missing_api_key`	Заголовок Authorization не передан
401	`invalid_api_key`	Ключ недействителен или отозван
429	`rate_limited`	Превышен лимит 60 req/min
404	`not_found`	Объект не существует или не принадлежит вашей org
402	`upgrade_required`	Тариф не позволяет использовать API (нужен Бизнес+)

Webhook

В разработке. Будет POST на ваш URL когда прилетит новый отзыв, с HMAC-подписью в заголовке X-MARPS-Signature. Ожидаем релиз в течение 1-2 недель.

Поддержка

Вопросы по интеграции — пишите на hello@marps.ru. Для крупных клиентов готовы согласовать SLA по API.