> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # Создание монитора > Создать монитор данных: постоянно активное наблюдение, которое непрерывно выявляет важные для вас бизнес-сигналы — новые вакансии, новости, рекламу или движения по экспансии на рынки — среди заданных вами компаний и фильтров, обогащает каждое совпадение данными о компании и контактами и доставляет их в выбранную точку назначения (email или webhook) по заданному вами расписанию. Настройте его поле за полем либо опишите весь монитор одной фразой на естественном языке с помощью `query`, и она будет интерпретирована в конфигурацию в рамках того же запроса. ## OpenAPI ````yaml ru-openapi POST /monitors/create openapi: 3.0.0 info: description: >- API Pubrio предоставляет данные об экспансии на рынки — сигналы в реальном времени, отмечающие выход компании на новый рынок, — вместе с лежащими в их основе данными о компаниях и людях. Выполняйте поиск, просмотр и обогащение данных об аккаунтах и контактах, а также подписывайтесь на типизированные сигналы движения с указанием даты по более чем 200 рынкам. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/ru/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/ru/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: Информация о профиле рабочей области и статистика использования - name: Enrichment description: Обогащение записей о людях и компаниях подробными B2B-данными - name: Lookalike description: Поиск компаний, похожих на заданную компанию - name: Search description: >- Поиск людей, компаний, вакансий, новостей и рекламы с использованием фильтров - name: Lookup description: >- Просмотр подробной информации о конкретных людях, компаниях, вакансиях, новостях, рекламе и технологиях - name: LinkedIn description: Просмотр данных о людях и компаниях по URL профиля LinkedIn - name: Redeem description: >- Погашение кредитов для получения контактных данных людей (по одному и пакетно) - name: Channels description: >- Управление шаблонами каналов для рассылок (создание, обновление, удаление, список) - name: Monitor description: >- Создание мониторов данных и управление ими с вебхуками, статистикой и обработкой - name: Filters description: >- Получение доступных значений фильтров для параметров поиска (технологии, местоположения, отрасли и т. д.) - name: API Keys description: >- Просмотр списка и анализ журналов запросов API и статистики использования ключей API - name: Insights description: Агрегированные данные по сигналам компаний (вакансии, новости, реклама). - name: Export description: Массовый экспорт данных (расходует кредиты). - name: Expansion description: 'Данные об экспансии компаний на рынки: сигналы, стадии, рынки и экспорт.' externalDocs: description: >- API Pubrio используется для поиска, предварительного просмотра и обогащения контактов и аккаунтов. База данных Pubrio предоставляет обширные B2B-контакты и данные для анализа продаж. url: https://docs.pubrio.com paths: /monitors/create: post: tags: - Monitor summary: Создание монитора description: >- Создать монитор данных: постоянно активное наблюдение, которое непрерывно выявляет важные для вас бизнес-сигналы — новые вакансии, новости, рекламу или движения по экспансии на рынки — среди заданных вами компаний и фильтров, обогащает каждое совпадение данными о компании и контактами и доставляет их в выбранную точку назначения (email или webhook) по заданному вами расписанию. Настройте его поле за полем либо опишите весь монитор одной фразой на естественном языке с помощью `query`, и она будет интерпретирована в конфигурацию в рамках того же запроса. operationId: monitors_create parameters: [] requestBody: required: true content: application/json: schema: type: object properties: name: type: string description: Название монитора. description: type: string description: Описание монитора. status: type: string description: >- Статус жизненного цикла для создания монитора. По умолчанию `active`. Используйте `draft`, чтобы сохранить недостроенный монитор: обязательно только поле `name`, проверка откладывается до активации, и черновик никогда не запускается. enum: - draft - active - paused - inactive default: active detection_mode: type: string description: >- Как обнаруживаются сигналы. `signal_first` сканирует рынок в широком масштабе; `company_first` отслеживает именованный список аккаунтов и требует хотя бы одну компанию, домен или URL LinkedIn. **Неизменяемо после создания** — изменение этого параметра у существующего монитора возвращает `40021`. Вместо этого создайте новый монитор. enum: - company_first - signal_first signal_types: type: array items: type: string enum: - jobs - news - advertisements - expansions description: Типы отслеживаемых сигналов. signal_filters: type: array items: type: object required: - signal_type properties: signal_type: type: string enum: - jobs - news - advertisements - expansions description: Какой поток фильтрует эта запись. filters: type: object description: >- Фильтры для этого потока. `jobs`, `news` и `advertisements` принимают параметры [Job Search](/en/api-reference/endpoint/companies/job_search), [News Search](/en/api-reference/endpoint/companies/news_search) и [Advertisement Search](/en/api-reference/endpoint/companies/advertisements_search). `expansions` использует словарь [Expansion Search](/en/api-reference/endpoint/expansions/market_lookup): `froms` / `tos`, `window_days`, `stages`, `scopes`, `momentum`, `freshness`, `signal_types`, `signal_subtypes`, `signal_strengths`, `source_types`. Слаги можно получить из [Expansion Reference](/en/api-reference/endpoint/expansions/types). description: >- По одной записи на каждый поток сигналов, который отслеживает монитор. example: - signal_type: jobs filters: locations: - US - signal_type: news filters: locations: - US - signal_type: advertisements filters: target_locations: - US - signal_type: expansions filters: tos: - US stages: - expanding - scaling signal_types: - HIRE - EXEC signal_strengths: - high - very_high company_filters: type: object description: >- Глобальные фильтры компаний, применяемые как второй уровень для всех типов сигналов. Принимает те же параметры, что и эндпоинт [Company Search](/en/api-reference/endpoint/companies/search) — местоположения, число сотрудников, технологии, отрасли и другое. example: locations: - US employees: - - 501 - 1000 - - 1001 - 5000 companies: type: array items: type: string format: uuid description: >- Список UUID domain_search_id компаний для мониторинга. Используется в основном в режиме company_first для указания целевых компаний. В качестве альтернативы можно использовать `domains` или `linkedin_urls` — требуется только один из трёх вариантов. domains: type: array items: type: string description: >- Список доменов компаний для мониторинга (например, ["openai.com", "google.com"]). Альтернатива `companies` — Pubrio сопоставляет их с соответствующими компаниями. Требуется только один из вариантов: `companies`, `domains` или `linkedin_urls`. linkedin_urls: type: array items: type: string format: uri description: >- Список URL компаний в LinkedIn для мониторинга (например, ["https://linkedin.com/company/pubrio"]). Альтернатива `companies` — Pubrio сопоставляет их с соответствующими компаниями. Требуется только один из вариантов: `companies`, `domains` или `linkedin_urls`. is_company_enrichment: type: boolean description: Обогащать ли данные компании в результатах. is_people_enrichment: type: boolean description: Обогащать ли данные людей в результатах. people_enrichment_configs: type: array items: type: object description: >- Массив слоёв обогащения данных о людях. Каждый слой выполняет независимый поиск людей. Содержит `max_people_to_return` (1-25), `people_contact_types` (массив — типы контактов из [Redeem](/en/api-reference/endpoint/redeem/people): email-work, email-personal, phone) и `filters` (те же параметры, что и в эндпоинте [People Search](/en/api-reference/endpoint/people/search)). example: - filters: people_locations: - US max_people_to_return: 3 people_contact_types: - email-work destination_type: type: string description: Тип точки доставки. enum: - webhook - email - sequences destination_config: type: object description: >- Конфигурация точки доставки. Для webhook: требуется `webhook_url` (строка), необязательные `headers` (объект) и `body` (объект). Для email: принимает `email` (строка) или `emails` (массив строк). Для последовательностей (sequences): требуется `sequence_identifier` (строка) плюс хотя бы одно из `is_people_search_enrolled` / `is_company_contact_enrolled`, установленное в true. example: webhook_url: https://your-webhook.com/endpoint headers: Authorization: Bearer token body: pipeline: my-webhook frequency_minute: type: integer description: >- Частота срабатывания в минутах. Мин: 0, Макс: 10080, По умолчанию: 0. minimum: 0 maximum: 10080 default: 0 max_failure_trigger: type: integer description: >- Максимальное количество последовательных сбоев до приостановки монитора. Мин: 1, Макс: 10, По умолчанию: 5. minimum: 1 maximum: 10 default: 5 max_daily_trigger: type: integer description: >- Максимальное количество срабатываний в день. Мин: 0, Макс: 86400, По умолчанию: 500. minimum: 0 maximum: 86400 default: 500 max_records_per_trigger: type: integer description: >- Определяет максимальное количество записей, доставляемых за одно срабатывание. Меньшие значения уменьшают размер полезной нагрузки при каждой доставке, что рекомендуется для больших наборов результатов или интеграций с ограничением частоты запросов. Мин: 1, Макс: 100, По умолчанию: 25. См. [Setting up Webhooks](/en/developer-guides/setting-up-webhooks) для рекомендаций. minimum: 1 maximum: 100 default: 25 notification_email: type: string format: email description: Email-адрес для уведомлений о сбоях монитора. max_retry_per_trigger: type: integer description: >- Максимальное количество повторных попыток на срабатывание. Мин: 0, Макс: 3, По умолчанию: 1. minimum: 0 maximum: 3 default: 1 retry_delay_second: type: integer description: >- Задержка между повторными попытками в секундах. Мин: 1, Макс: 5, По умолчанию: 1. minimum: 1 maximum: 5 default: 1 query: type: string maxLength: 2000 description: >- Описание монитора на естественном языке (на любом языке), например «отслеживать компании, выходящие на рынок Японии, получать руководителей уровня C с их рабочим email и отправлять оповещения на me@company.com в реальном времени». Оно интерпретируется в поля ниже (detection_mode, signal_types, signal_filters, people_enrichment_configs, destination_type/destination_config, frequency_minute) в рамках того же запроса. Любое поле, переданное вами явно, переопределяет интерпретированное значение. Если текст не является запросом на создание монитора, вызов возвращает 400. Ограничение — 2000 символов. deep: type: boolean description: >- Необязательно, используется только с `query`. Выполнить проход рефлексии для более высокой точности интерпретации (по умолчанию true; примерно удваивает задержку интерпретации). Установите false для более быстрого однопроходного варианта. anyOf: - title: Natural language required: - query - title: Structured fields required: - name - detection_mode - signal_types - destination_type - destination_config - title: Draft required: - name - status responses: '200': description: Успешный ответ с данными только что созданного монитора. content: application/json: schema: type: object properties: data: type: object properties: monitor_id: type: string format: uuid description: >- Уникальный идентификатор только что созданного монитора. name: type: string description: Название монитора. description: type: string description: Описание монитора. detection_mode: type: string description: 'Режим обнаружения: ''company_first'' или ''signal_first''.' signal_types: type: array items: type: string description: Типы сигналов, отслеживаемые этим монитором. signal_filters: type: array items: type: object description: >- Фильтры по каждому типу сигнала в сохранённом виде. Если монитор создан с помощью `query`, здесь показано, во что было интерпретировано ваше предложение — проверьте, чтобы убедиться, что монитор отслеживает именно то, что вы имели в виду. company_filters: type: object description: >- Фильтры профиля компании, применяемые к каждому найденному сигналу. companies: type: array items: type: string description: Отслеживаемые компании (company_first). is_company_enrichment: type: boolean description: Обогащаются ли совпадения данными о компании. is_people_enrichment: type: boolean description: Обогащаются ли совпадения данными о людях и контактах. people_enrichment_configs: type: array items: type: object description: >- Настройки обогащения данных о людях в сохранённом виде. destination_type: type: string description: Тип точки доставки. destination_config: type: object description: Данные точки доставки (email-адреса или URL вебхука). frequency_minute: type: integer description: Как часто запускается монитор, в минутах. notification_email: type: string nullable: true description: Адрес, уведомляемый о состоянии самого монитора. max_retry_per_trigger: type: integer description: >- Допустимое количество повторных попыток на срабатывание. retry_delay_second: type: integer description: Задержка между повторными попытками, в секундах. max_records_per_trigger: type: integer description: >- Максимальное количество записей, доставляемых за одно срабатывание. max_daily_trigger: type: integer description: Максимальное количество срабатываний в день. max_failure_trigger: type: integer description: >- Количество последовательных сбоев до остановки монитора. status: type: string enum: - draft - active - paused - inactive description: Статус жизненного цикла, с которым был создан монитор. masked_signature: type: string description: Замаскированная подпись вебхука для отображения. created_at: type: string format: date-time description: Время создания монитора. signature: type: string format: uuid description: >- Подпись вебхука для проверки полезной нагрузки. Возвращается только при создании. example: data: monitor_id: c9cd5421-b327-4243-9cd7-8b341b3da8bd name: Expansion signals → JP description: null detection_mode: signal_first signal_types: - expansions signal_filters: - signal_type: expansions filters: tos: - JP company_filters: {} companies: [] is_company_enrichment: false is_people_enrichment: true people_enrichment_configs: - max_people_to_return: 5 filters: management_levels: - c_suite people_contact_types: - email-work destination_type: email destination_config: emails: - me@company.com frequency_minute: 5 notification_email: null max_retry_per_trigger: 3 retry_delay_second: 60 max_records_per_trigger: 100 max_daily_trigger: 24 max_failure_trigger: 5 status: active masked_signature: 5••••••••••••••8b8 created_at: '2026-07-16T10:27:40.469Z' signature: 52209a0d-f1c8-4111-a685-ac86edc678b8 '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: responses: general_error: description: >- Некорректный запрос. Запрос был некорректно сформирован или содержал недопустимые параметры. Подробности см. в коде и сообщении об ошибке. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Errors and codes will vary depending on the scenario, please see the documentation for information. type: string details: type: object rate_limit_error: description: >- Превышен лимит запросов. За заданный период времени было сделано слишком много запросов. Повторите попытку после сброса окна лимита запросов. content: application/json: schema: required: - error type: object properties: error: example: Request rate limit exceeded. Please wait and try again later. type: string server_error: description: >- Внутренняя ошибка сервера. На сервере произошла непредвиденная ошибка. Если ошибка повторяется, обратитесь в службу поддержки. content: application/json: schema: required: - error type: object properties: error: example: An unexpected error occurred on the server. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- Уникальный токен API, представляющий действия, которые вы выполняете через API, и соответствующие права доступа и операции. Вы можете создать его в разделе [Settings](https://dashboard.pubrio.com/#/settings/). in: header ````