示例：追踪职位发布

本指南演示两个实际场景。每个代码块都可以直接复制、粘贴和运行——只需将 YOUR_API_KEY 替换为你的实际密钥。

公司优先：追踪 OpenAI
信号优先：发现 AI 招聘

场景：监控 OpenAI 何时发布新职位

你希望在 OpenAI 发布职位空缺时立即收到通知——并自动获取其工程领导层的联系方式。

创建 monitor

curl -X POST https://api.pubrio.com/monitors/create \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "name": "OpenAI Job Tracker",
    "detection_mode": "company_first",
    "signal_types": ["jobs"],
    "signal_filters": [
      {
        "signal_type": "jobs",
        "filters": {
          "locations": ["US"]
        }
      }
    ],
    "companies": [
      "67c4696b-b7b0-46b5-b2af-9f434543661e"
    ],
    "is_company_enrichment": true,
    "is_people_enrichment": true,
    "people_enrichment_configs": [
      {
        "max_people_to_return": 5,
        "people_contact_types": ["email-work"],
        "filters": {
          "management_levels": ["director", "vp"],
          "departments": ["master_engineering"]
        }
      }
    ],
    "destination_type": "webhook",
    "destination_config": {
      "webhook_url": "https://usewebhook.com/YOUR_WEBHOOK_ID",
      "headers": {
        "Authorization": "Bearer your-secret-token"
      }
    },
    "max_records_per_trigger": 5,
    "profile_id": 1
  }'

功能说明：

监控 OpenAI（domain_search_id: 67c4696b-...）的美国新职位发布
补充公司数据并查找最多5位总监/副总裁级别的工程联系人
每次触发最多投递5条记录到你的 webhook
所有其他设置使用合理的默认值（实时频率、每日500次上限等）

在 company_first 模式中，你通常只需要 companies、domains 或 linkedin_urls 和信号筛选。company_filters 是可选的——当你希望将关注列表与更广泛的公司条件结合时，它会添加第二层筛选。

立即测试

不要等待计划扫描——触发一次手动运行以验证一切正常。使用 tried_at 设置一个过去的时间戳以确保有可用数据（使用当前时间可能因尚未出现新信号而返回0条结果）：

curl -X POST https://api.pubrio.com/monitors/process/try \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "monitor_id": "YOUR_MONITOR_ID",
    "tried_at": "2026-01-01T00:00:00.000Z",
    "profile_id": 1
  }'

手动触发与计划触发一样消耗积分。使用 tried_at 设置近期的过去日期以获取具有代表性的测试结果。

检查结果

几秒钟后，在 usewebhook.com 检查你的 webhook URL 以查看负载。你也可以通过日志验证：

curl -X POST https://api.pubrio.com/monitors/statistics/logs \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "profile_id": 1,
    "monitor_id": "YOUR_MONITOR_ID",
    "page": 1,
    "per_page": 5
  }'

每个日志条目显示状态、信号/公司/人员数量、积分用量和处理时间。

场景：发现正在招聘 AI/ML 岗位的公司

你想找到正在积极组建 AI 团队的公司——无论你之前是否追踪过它们。这是一个潜客挖掘的使用场景。

创建 monitor

curl -X POST https://api.pubrio.com/monitors/create \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "name": "AI Hiring Discovery",
    "detection_mode": "signal_first",
    "signal_types": ["jobs"],
    "signal_filters": [
      {
        "signal_type": "jobs",
        "filters": {
          "titles": ["Machine Learning", "AI Engineer", "Data Scientist"],
          "locations": ["US"]
        }
      }
    ],
    "company_filters": {
      "employees": [[201, 500], [501, 1000], [1001, 5000]]
    },
    "is_company_enrichment": true,
    "is_people_enrichment": true,
    "people_enrichment_configs": [
      {
        "max_people_to_return": 3,
        "people_contact_types": ["email-work"],
        "filters": {
          "management_levels": ["founder", "c_suite", "vp"]
        }
      }
    ],
    "destination_type": "webhook",
    "destination_config": {
      "webhook_url": "https://usewebhook.com/YOUR_WEBHOOK_ID",
      "body": {
        "pipeline": "ai-prospecting"
      }
    },
    "max_records_per_trigger": 10,
    "profile_id": 1
  }'

功能说明：

扫描美国的 AI/ML 职位发布
全局公司筛选将结果缩小到中型公司（201-5,000名员工）——这就是将信号与公司条件结合的强大之处
补充公司信息并查找最多3位创始人/C 级高管/副总裁联系人
在负载中添加自定义 pipeline 字段用于在 webhook 处理程序中路由
默认实时频率

立即测试

curl -X POST https://api.pubrio.com/monitors/process/try \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "monitor_id": "YOUR_MONITOR_ID",
    "tried_at": "2026-01-01T00:00:00.000Z",
    "profile_id": 1
  }'

手动触发消耗积分。使用 tried_at 设置近期的过去日期以获取具有代表性的测试数据——使用当前时间可能因该时刻未出现新信号而返回0条结果。

你将收到的内容

检查 usewebhook.com — 你将看到以信号为主要结构的 signal_first 负载。注意根级别来自 destination_config.body 的自定义 pipeline 字段：

{
  "monitor": { ... },
  "metadata": {
    "total_signals": 5,
    "total_companies": 4,
    "total_people": 10
  },
  "triggered_at": "2026-04-06T14:30:00.000Z",
  "signals": [
    {
      "signal_type": "jobs",
      "signal": { ... },
      "companies": [
        {
          "company_name": "...",
          "domain": "...",
          "company_size": 800,
          "people": [...],
          ...
        }
      ]
    },
    ...
  ],
  "pipeline": "ai-prospecting"
}

重试失败的投递

如果某次触发失败了（例如你的 webhook 临时不可用），可以重试它而无需重新运行整个扫描：

curl -X POST https://api.pubrio.com/monitors/process/retry \
  -H "Content-Type: application/json" \
  -H "pubrio-api-key: YOUR_API_KEY" \
  -d '{
    "monitor_id": "YOUR_MONITOR_ID",
    "monitor_log_id": "THE_FAILED_LOG_ID",
    "profile_id": 1
  }'

通过查询统计日志并筛选 "status": "failed" 的条目来找到 monitor_log_id。

监控

场景：监控 OpenAI 何时发布新职位

创建 monitor

立即测试

检查结果

场景：发现正在招聘 AI/ML 岗位的公司

创建 monitor

立即测试

你将收到的内容

重试失败的投递

后续步骤

最佳实践

Webhook 设置

监控

​场景：监控 OpenAI 何时发布新职位

​创建 monitor

​立即测试

​检查结果

​场景：发现正在招聘 AI/ML 岗位的公司

​创建 monitor

​立即测试

​你将收到的内容

​重试失败的投递

​后续步骤

最佳实践

Webhook 设置

场景：监控 OpenAI 何时发布新职位

创建 monitor

立即测试

检查结果

场景：发现正在招聘 AI/ML 岗位的公司

创建 monitor

立即测试

你将收到的内容

重试失败的投递

后续步骤