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 個。
