REST 请求发送到
https://api.worldmonitor.app，并携带 X-WorldMonitor-Key: wm_... 请求头。密钥说明见认证，各方案配额见速率限制。
各数据流返回的记录
下表字段名即路由返回的 JSON 字段名。动荡、新闻和历史记录在生产方提供链接时会附上原始报道链接；UCDP 事件以文本形式注明原始来源。UCDP 事件（list-ucdp-events）
动荡事件（list-unrest-events）
来自 GDELT 的记录是媒体信号，而非经过核实的事件。路由返回这类记录时会标记
confidence: CONFIDENCE_LEVEL_LOW，类型和严重程度为未指定，摘要会说明当地事件未经核实。
新闻聚类（get_news_clusters，MCP）
聚类把不同媒体报道同一事件的标题归为一组。
REST 摘要返回的是底层标题而非聚类。每个条目包含
title、source、link、publishedAt、threat、提取到地点时的 location 和 locationName、importanceScore、corroborationCount 以及 credibilityScore。
历史记录（get-intel-timeline、search-intel-history）
历史记录带有国家，但不含坐标。
筛选条件
列表路由在一次响应中返回整个当前快照，没有游标分页。当有界读取可能遗漏更早的匹配时，历史路由会设置
partial: true；无法访问存储时会设置 upstreamUnavailable: true。此时的空列表表示读取失败，而不是没有事件。
保留期限：每个数据流能追溯多远
依据 2026 年 10 月 17 日的代码核对。
如需更长的记录，请轮询这些数据流并自行存储。历史记录按
id 去重，动荡和 UCDP 记录按生产方 id 去重。较早的标题加入聚类时，新闻聚类的 id 可能变化，因此不要把它当作持久键。
新条目的 webhook
告警规则会把匹配事件实时推送到 webhook，或按每日、每日两次、每周摘要推送。规则可按事件类型、严重程度（all、high、critical）和国家筛选。每次投递都在 X-WM-Signature 中使用 HMAC-SHA256 签名。你需要以付费方案登录，在仪表盘的通知设置中配置 webhook 和规则。
实时投递包含 eventType、severity、timestamp，以及字段随事件类型而定的 payload。请把 payload 的每个字段都视为可选。新闻告警（rss_alert）包含 title、source、link、publishedAt、importanceScore 和 corroborationCount。冲突告警（conflict_escalation）包含 title 和 source，国家解析成功时另含 countryCode，不含 link。payload 不含稳定的事件 ID，也不含坐标。信封格式和校验示例见通知参考。
代码
使用官方 SDK 的 Python 示例：client.Get、client.CallTool）和 Ruby（client.get、client.call_tool）SDK 提供相同的调用。在命令行中，npm CLI 也能完成同样的操作：
方案与价格
这些方案均为自助订阅，价格公布在定价页。结账在浏览器中完成，无需联系销售。
构建前须知
- World Monitor 聚合已发布的报道，不在现场核实事件；来自 GDELT 的记录是媒体信号。
- 并非所有上游来源都已完成条款审查。再分发数据前请确认复用条款。免费的
get_sourcesMCP 工具会列出每个媒体的层级和审查状态。 - 没有公布的可用性 SLA。
- 计划中的工作：带游标分页、保留期更长的历史端点，见 issue #4276 和 issue #5745。