Перейти к основному содержимому

Как выгрузить данные через Platform API

Выгрузка отзывов, вопросов и ответов, рейтингов товаров и результатов опросов методом «Задачи на экспорт» Platform API.

Выгружайте данные через Platform API, когда их нужно регулярно синхронизировать с вашими системами, индексировать или складывать в аналитику. Разовый отчёт быстрее получить из личного кабинета.

Процесс общий для всех коллекций. Различаются значение records_type, фильтры и состав полей в файле.

Что понадобится​

Какие коллекции доступны по API и какие действуют лимиты — см. Экспорт данных: коллекции, форматы и лимиты.

Порядок выгрузки​

  1. Создайте задачу на экспорт с нужным records_type.
  2. Раз в минуту проверяйте статус задачи.
  3. Скачайте файл по ссылке из ответа, когда статус станет completed.
  4. Создайте следующую задачу на очередную порцию данных, если объём превышает лимит одного экспорта.

Для периодической синхронизации делайте выгрузку не чаще раза в сутки. Если данные нужны чаще, экспорты не подходят: забирайте изменения постраничным обходом или получайте их вебхуками.

Настройка запроса​

Выгрузка только изменений​

Чтобы не тянуть каждый раз всю коллекцию, добавьте в search_options фильтр по времени последнего обновления записи. В gt подставляйте дату и время предыдущей успешной выгрузки.

"search_options": {
"filter": {
"updated_at": {
"gt": "YYYY-MM-DDThh:mm:ss+03:00"
}
}
}

Остальные атрибуты для фильтрации перечислены в описании метода по соответствующей коллекции, операторы — в разделе «Фильтрация» документации Platform API.

Состав полей в файле​

Параметр export_format задаёт, какие атрибуты и в каком порядке попадут в файл CSV или XLSX1. Готовый набор копируется из личного кабинета: Админ → Данные → Форматы экспорта. Как его собрать, описано в статье Как настроить формат выгрузки данных.

Параметры по коллекциям​

"records_type": "reviews"

"export_format": "[.id?, .created_at?, .state?, .order_number?, .context_type?, .product_id?, .product.name?, .product.url?, .category.name?, .brand.name?, .location_name?, .rating?, .body?, .pros?, .cons?, .recommended?, .likes?, .dislikes?]"
warning

Отзывы из внешних источников, полученные по услуге агрегации, в экспорты не попадают, если иное не предусмотрено вашим тарифом и договором. Подключение услуги обсуждается с менеджером Aplaut.

Примечания​

  1. При выгрузке в JSONL export_format игнорируется: Aplaut отдаёт все данные по коллекции. ↩