Perplexity 官方开发者文档与价表页面现已公开 Monitor API 文档树与计费限额说明(官方更新日志中暂无单独标注发布日期的 Monitor API 条目,概览文档示例创建时间戳日历日为 2026 年 11 月 13 日,属于文档公开梳理而非当日新品首发)。开发者可通过 REST 接口 POST /v1/monitors 或 API Console 配置定时网络监控任务。

Search 与 Page 双模式监控及生命周期管理

两种监控目标(不可在同一 Monitor 中混用):Monitor API 支持按时间表自动检查网络并保存结果供 API 读取:Search 模式用于按查询词发现新 URL,Page 模式用于跟踪 1 至 10 个已知 URL 的文本内容变化;单个 monitor 只能配置一个 Search 目标或 1 至 10 个 Page 目标,两者不可混合设置。

调度周期、状态留存与自动暂停规则:创建 monitor 时可设定监控目标(goal)与运行间隔(例如 1h、6h、1d、1w 等),首次运行会立即异步触发,随后按周期执行并对比历史状态以在 changes 中记录新发现或页面变更(Page 抓取或处理错误记录在 target_errors 中),运行历史保留 90 天。支持通过接口手动立即运行、暂停(pause)、恢复(resume)或删除;若暂停超过 90 天,状态可能过期从而重新建立基线。此外,当账户积分不足(insufficient_credits)或 Webhook 持续失败时,monitor 会自动暂停,充值或修复后需显式调用 resume 恢复。可选配的 webhook.url 须为不含内嵌凭证且不超过 2,048 字节的公开 HTTPS 地址,接收端须在 10 秒内返回 2xx。

零数据保留组织限制:根据文档错误码说明,凡是组织策略要求零数据保留(zero data retention)的组织,均无法创建、恢复或运行 monitors(调用将返回 403)。

官方计费单价与组织分档限额

按成功单元计价(失败与跳过免费):根据官方价表,Search 监控按每次成功 Search 运行 0.001 美元(每千次 1 美元)计费(即使单次运行内部执行了多次搜索或未返回发现也仅计费 1 次);Page 监控按每次成功 Page 运行中计费的抓取 URL 每个 0.001 美元(每千个 1 美元)计费;所有失败(failed)或跳过(skipped)的运行均不收费。

组织共享 HTTP 预算与活跃 Monitor 上限:Monitor API 的 HTTP 请求预算在组织内所有 API Key 之间共享(独立于 Agent API 预算),每次管理或轮询查询均消耗 1 次请求。标准组织每秒请求数上限按层级划分为 Tier 0(1 次/秒)、Tier 1(3 次/秒)、Tier 2(8 次/秒)、Tier 3(17 次/秒)、Tier 4 与 Tier 5(均为 33 次/秒);活跃 monitor 数量上限(Search 与 Page 合计,不含已暂停项)为 Tier 0 与 Tier 1 各 100 个、Tier 2 为 200 个、Tier 3 为 300 个、Tier 4 为 400 个、Tier 5 为 500 个。