> ## 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. # 创建监控 > 使用指定的检测规则和 Webhook 配置创建新的数据监控。 ## OpenAPI ````yaml cn-openapi POST /monitors/create openapi: 3.0.0 info: description: >- Pubrio API 提供市场扩张情报——实时捕捉企业进入新市场的信号，以及其底层的公司与人员数据。可搜索、查找并丰富账户与联系人信息，并订阅覆盖 200+ 市场、带类型与日期的动向信号。 version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/zh-CN/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/zh-CN/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: 通过 LinkedIn 个人资料 URL 查找人员和公司数据 - name: Redeem description: 兑换积分以解锁人员联系方式（单个和批量） - name: Channels description: 管理外展渠道模板（创建、更新、删除、列表） - name: Monitor description: 创建和管理数据监控，包括 Webhook、统计和处理 - name: Filters description: 获取搜索参数的可用筛选值（技术、地点、垂直领域等） - name: API Keys description: 查看 API 密钥的请求日志和使用情况分析 - name: Insights description: 公司的信号聚合洞察(招聘、新闻、广告)。 - name: Export description: 批量数据导出(消耗积分)。 - name: Expansion description: 公司市场扩张情报:信号、阶段、市场与导出。 externalDocs: description: Pubrio API 用于搜索、预览和增强联系人及账户信息。Pubrio 数据库提供丰富的 B2B 联系人和销售情报数据。 url: https://docs.pubrio.com paths: /monitors/create: post: tags: - Monitor summary: 创建监控 description: 使用指定的检测规则和 Webhook 配置创建新的数据监控。 operationId: monitors_create parameters: [] requestBody: required: true content: application/json: schema: type: object properties: name: type: string description: 监控名称。 description: type: string description: 监控描述。 detection_mode: type: string description: 检测模式：'company_first' 先查找公司再检查信号，'signal_first' 先查找信号再匹配公司。 enum: - company_first - signal_first signal_types: type: array items: type: string enum: - jobs - news - advertisements description: 要监控的信号类型。 signal_filters: type: array items: type: object description: >- 信号过滤器对象数组。每个对象包含 `signal_type`（jobs、news、advertisements 之一）和 `filters`（包含信号特定参数的对象）。请参见 [Job Search](/cn/api-reference/endpoint/companies/job_search)、[News Search](/cn/api-reference/endpoint/companies/news_search) 或 [Advertisement Search](/cn/api-reference/endpoint/companies/advertisements_search) 了解过滤器参数。 example: - filters: locations: - US signal_type: jobs - filters: locations: - US signal_type: news - filters: target_locations: - US signal_type: advertisements company_filters: type: object description: >- 全局公司过滤器，作为第二层应用。接受与[Company Search](/cn/api-reference/endpoint/companies/search)端点相同的参数 — locations、employees、technologies、verticals 等。 example: locations: - US employees: - - 501 - 1000 - - 1001 - 5000 companies: type: array items: type: string format: uuid description: >- 要监控的公司 domain_search_id UUID 列表。主要在 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: >- LinkedIn 公司主页 URL 列表（如 ["https://linkedin.com/company/pubrio"]）。可作为 `companies` 的替代方式。三者填写其一即可。 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](/cn/api-reference/endpoint/redeem/people) 端点：email-work、email-personal、phone）和 `filters`（与[People Search](/cn/api-reference/endpoint/people/search)端点相同的参数）。详见人员搜索端点了解可用过滤器，Redeem 端点了解联系类型。 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`（字符串）。sequences 类型需要 `sequence_identifier`（字符串）和 `record_type`（字符串）。 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。详情请参阅 [配置 Webhooks](/cn/developer-guides/setting-up-webhooks)。 minimum: 1 maximum: 100 default: 25 notification_email: type: string format: email description: 监控失败通知的邮箱地址。 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 profile_id: $ref: '#/components/schemas/profile_id' required: - name - detection_mode - signal_types - destination_type - destination_config 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'。 destination_type: type: string description: 投递目标类型。 is_active: type: boolean description: 监控是否处于活动状态。 is_paused: type: boolean description: 监控是否已暂停。 masked_signature: type: string description: 用于显示的已遮罩 webhook 签名。 created_at: type: string format: date-time description: 监控创建的时间戳。 signature: type: string format: uuid description: 用于验证负载的 webhook 签名。仅在创建时返回。 example: data: monitor_id: c3d4e5f6-a7b8-9012-cdef-123456789012 name: My Monitor description: Monitors news and job signals for target companies detection_mode: signal_first destination_type: webhook is_active: true is_paused: false masked_signature: 7••••••••••••••••8df created_at: '2026-04-05T20:30:17.792Z' signature: d4e5f6a7-b8c9-0123-defa-234567890123 '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: profile_id: type: integer description: >- 可选。发起请求的团队标识符。由于 API 密钥已包含您的工作区信息，此参数不再是必填项。如果提供，该 ID 有助于将查找与特定团队（工作区）关联，实现数据检索和额度追踪。 更多信息请参见团队标签下的 `user details` 端点。 responses: general_error: description: 请求错误。请求格式不正确或包含无效参数。请检查错误代码和消息以获取详细信息。 content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: 错误及代码会根据不同场景有所不同，详情请参阅文档。 type: string details: type: object rate_limit_error: description: 超出速率限制。在给定时间段内发送了过多请求。请在速率限制窗口重置后重试。 content: application/json: schema: required: - error type: object properties: error: example: 请求频率超出限制。请稍后再试。 type: string server_error: description: 内部服务器错误。服务器发生意外错误。如果错误持续存在，请联系支持团队。 content: application/json: schema: required: - error type: object properties: error: example: 服务器在处理请求时遇到了未预料的异常。 type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- 一个唯一的 API 令牌，用于标识您通过 API 执行的操作以及相应的权限和操作。您可以在 [设置](https://dashboard.pubrio.com/#/settings/) 部分创建该令牌。 in: header ````