Список сегментов
Получить все сегменты текущего пользователя, включая название, описание, цвет, тип и количество контрагентов в каждом сегменте.
Сохраняйте результаты поиска компаний в именованные списки и сегменты — один раз задайте критерии или отберите контрагентов вручную, затем работайте с готовой подборкой по ID, без повторного ввода фильтров. Статические списки подходят для фиксированных наборов (клиенты, проверенные контрагенты), сегменты на фильтрах — для динамических выборок, которые обновляются при изменении данных.
- Сохраняйте подборки: после поиска по batch-фильтрам (Пакетное API, API Фильтры) создайте статичный список или динамичный сегмент с конфигурацией фильтра — критерии поиска больше не нужно вводить заново;
- Ведите портфели контрагентов: группируйте компании по сценариям (лиды, поставщики, мониторинг), добавляйте и переносите контрагентов между списками;
- Автоматизируйте регулярные процессы: используйте сохранённый сегмент как вход для экспорта, массовой проверки и других API — один идентификатор сегмента вместо сложного запроса каждый раз;
- Поддерживайте актуальность выборки: сегменты пересчитываются по сохранённым критериям, списки остаются под вашим ручным контролем.
Формат запроса
https://api.datanewton.ru/v1/segmentAPI-ключ для авторизации
https://api.datanewton.ru/v1/segment?key=mi76aFMdgvmlcontent_copy
Формат ответа
Набор сегментов пользователя
Название сегмента
Описание/комментарий
Дата создания
Дата обновления
Количество контрагентов в сегменте
порядковый номер
Признак того, что сегмент зарезервирован и не может быть удален/переименован
Цвет сегмента
Тип сегмента: static, filter_based
JSON конфигурация фильтра (для filter_based сегментов)
Дата последней материализации
Статус материализации: not_started, in_progress, completed, failed
Количество обработанных записей при материализации
Курсор для продолжения материализации (search_after)
Оценочное общее количество записей
Автоматически обновлять сегмент
Расписание обновления: daily, weekly, monthly
Песочница
К тестовому ключу также применяются ограничения стандартных ключей API. С помощью тестового ключа можно делать запросы по ограниченному списку ИНН и ОГРН(-ИП):