Skip to main content
POST
创建监控

授权

pubrio-api-key
string
header
必填

一个唯一的 API 令牌,用于标识您通过 API 执行的操作以及相应的权限和操作。您可以在 设置 部分创建该令牌。

请求体

application/json
query
string
必填

监控的自然语言描述(任意语言),例如“监控进入日本市场的公司,获取 C 级高管的工作邮箱,并实时发送提醒到 [email protected]”。它会在同一请求中被解析为下方字段(detection_mode、signal_types、signal_filters、people_enrichment_configs、destination_type/destination_config、frequency_minute)。你显式传入的任何字段都会覆盖解析出的值。若文本并非监控请求,将返回 400。最长 2000 个字符。

Maximum string length: 2000
name
string

监控名称。

description
string

监控描述。

status
enum<string>
默认值:active

创建监控时的生命周期状态。默认为 active。使用 draft 可保存尚未完成的监控:仅需 name,校验会推迟到启用时,草稿不会运行。

可用选项:
draft,
active,
paused,
inactive
detection_mode
enum<string>

检测模式:'company_first' 先查找公司再检查信号,'signal_first' 先查找信号再匹配公司。

可用选项:
company_first,
signal_first
signal_types
enum<string>[]

要监控的信号类型。

可用选项:
jobs,
news,
advertisements,
expansions
signal_filters
object[]

信号过滤器对象数组。每个对象包含 signal_type(jobs、news、advertisements 之一)和 filters(包含信号特定参数的对象)。请参见 Job SearchNews SearchAdvertisement Search 了解过滤器参数。

示例:
company_filters
object

全局公司过滤器,作为第二层应用。接受与Company Search端点相同的参数 — locations、employees、technologies、verticals 等。

示例:
companies
string<uuid>[]

要监控的公司 domain_search_id UUID 列表。主要在 company_first 模式下用于指定目标公司。也可使用 domainslinkedin_urls 作为替代方式 — 三者填写其一即可。

domains
string[]

公司域名列表(如 ["openai.com", "google.com"])。可作为 companies 的替代方式 — Pubrio 会自动解析对应的公司。companiesdomainslinkedin_urls 三者填写其一即可。

linkedin_urls
string<uri>[]

LinkedIn 公司主页 URL 列表(如 ["https://linkedin.com/company/pubrio"])。可作为 companies 的替代方式。三者填写其一即可。

is_company_enrichment
boolean

是否在结果中增强公司数据。

is_people_enrichment
boolean

是否在结果中增强人员数据。

people_enrichment_configs
object[]

人员增强层数组。每层执行独立的人员搜索。包含 max_people_to_return(1-25)、people_contact_types(联系类型数组,参见 Redeem 端点:email-work、email-personal、phone)和 filters(与People Search端点相同的参数)。详见人员搜索端点了解可用过滤器,Redeem 端点了解联系类型。

示例:
destination_type
enum<string>

投递目标类型。

可用选项:
webhook,
email,
sequences
destination_config
object

目标配置。Webhook:需要 webhook_url(字符串),可选 headers(对象)和 body(对象)。Email:接受 email(字符串)或 emails(字符串数组)。sequences 类型需要 sequence_identifier(字符串),并且 is_people_search_enrolled / is_company_contact_enrolled 至少有一个设为 true。

frequency_minute
integer
默认值:0

触发频率(分钟)。最小值:0,最大值:10080,默认值:0。

必填范围: 0 <= x <= 10080
max_failure_trigger
integer
默认值:5

暂停监控前的最大连续失败次数。最小值:1,最大值:10,默认值:5。

必填范围: 1 <= x <= 10
max_daily_trigger
integer
默认值:500

每日最大触发次数。最小值:0,最大值:86400,默认值:500。

必填范围: 0 <= x <= 86400
max_records_per_trigger
integer
默认值:25

控制每次触发最多推送的记录数量。较低的值可减少每次推送的数据量,适用于结果集较大或下游系统有速率限制的场景。最小值:1,最大值:100,默认值:25。详情请参阅 配置 Webhooks

必填范围: 1 <= x <= 100
notification_email
string<email>

监控失败通知的邮箱地址。

max_retry_per_trigger
integer
默认值:1

每次触发的最大重试次数。最小值:0,最大值:3,默认值:1。

必填范围: 0 <= x <= 3
retry_delay_second
integer
默认值:1

重试间隔(秒)。最小值:1,最大值:5,默认值:1。

必填范围: 1 <= x <= 5
profile_id
integer

可选。发起请求的团队标识符。由于 API 密钥已包含您的工作区信息,此参数不再是必填项。如果提供,该 ID 有助于将查找与特定团队(工作区)关联,实现数据检索和额度追踪。

更多信息请参见团队标签下的 user details 端点。

deep
boolean

可选,仅与 query 一起使用。运行反思校验以提高解析准确度(默认 true;解析延迟约翻倍)。设为 false 可获得更快的单次解析。

响应

成功响应,包含新创建的监控详情。

data
object