使用场景
监控竞争对手的定价页面
当竞争对手调整价格、功能或产品方案时即时获得告警
追踪法律/政策文档变更
监控服务条款、隐私政策或合规性文档
监视新闻网站的更新
实时检测特定页面上的突发新闻或文章更新
检测网站宕机或页面被篡改
当出现重大结构性变化(表明发生错误或攻击)时获得告警
监控 API 文档的破坏性变更
追踪 API 参考页面,及早发现弃用和破坏性变更
Endpoint
/api/v1/tools/track_changesParameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
url | string | Required | - | 要监控变更的 URL Example: https://competitor.com/pricing |
operation | string | Optional | compare | 操作类型:"create_baseline" | "compare" | "monitor" | "get_history" | "get_stats" Example: compare |
trackingOptions | object | Optional | - | 用于设置追踪内容及方式的选项 Example: {"granularity": "high", "ignoreWhitespace": true} |
monitoringOptions | object | Optional | - | 用于定时监控的选项 Example: {"enabled": true, "interval": "1h"} |
storageOptions | object | Optional | - | 用于变更历史存储的选项 Example: {"retainHistory": true, "maxHistoryEntries": 100} |
操作指南
适用于各种监控工作流的不同操作
Webhook 通知格式
当检测到的变更超过阈值时,会向您的 webhook 发送此载荷
请求示例
响应示例
{ "success": true, "data": { "comparison": { "changeScore": 0.35, "significance": "medium", "changes": [ { "type": "text", "description": "Pricing changed from $99/mo to $79/mo", "location": "div.pricing-card > span.price", "oldValue": "$99", "newValue": "$79", "impact": "high" }, { "type": "link", "description": "New \"Enterprise\" link added", "location": "nav.pricing-tiers", "action": "added", "url": "/pricing/enterprise", "impact": "medium" }, { "type": "structure", "description": "New section added: \"Compare Plans\"", "location": "main > section:nth-child(3)", "action": "added", "impact": "low" } ], "summary": "3 changes detected: 1 high impact, 1 medium impact, 1 low impact", "timestamp": "2025-10-15T14:30:00Z" }, "baseline": { "url": "https://competitor.com/pricing", "captured_at": "2025-10-15T12:00:00Z", "hash": "a1b2c3d4e5f6", "metrics": { "textLength": 4567, "linkCount": 23, "elementCount": 145 } }, "history": { "totalChecks": 48, "changesDetected": 5, "lastCheck": "2025-10-15T14:30:00Z", "nextCheck": "2025-10-15T15:30:00Z" } }, "credits_used": 3, "credits_remaining": 997, "processing_time": 2340}data.comparison.changeScore整体变更分数(0-1,其中 1 表示完全不同)data.comparison.significance根据 changeScore 划分为 low、medium 或 highdata.comparison.changes检测到的变更数组及其详情data.baseline.hash用于对比的基线内容的唯一哈希值data.history.nextCheck下次计划检查(如果已启用监控)credits_used每次操作固定消耗 3 credits(基线、对比、监控等)processing_time对比操作通常耗时 2-4 秒错误处理
未找到基线(400 Bad Request)
必须先运行 create_baseline 操作再进行对比。每个 URL 都需要各自的基线。
无效的监控间隔(400 Bad Request)
间隔必须为以下之一:15m、30m、1h、6h、24h。更短的间隔需要更高级别的套餐。
URL 无法访问(400 Bad Request)
目标 URL 返回错误或被屏蔽。请检查 URL 的可访问性和身份验证。
Webhook 失败(500 Internal Server Error)
Webhook URL 返回错误或超时。请确保端点可访问并返回 200 OK。
Credit 费用
费用明细:
create_baseline:3 credits(每个 URL 一次性)
compare:每次检查 3 credits
monitor(设置):3 credits(一次性)
定时检查:每次执行 3 credits
get_history:每次检索 3 credits
get_stats:每次检索 3 credits
监控费用示例:
1 小时监控间隔: 24 次检查/天 × 3 credits = 72 credits/天/URL
6 小时监控间隔: 4 次检查/天 × 3 credits = 12 credits/天/URL
24 小时监控间隔: 1 次检查/天 × 3 credits = 3 credits/天/URL
套餐推荐:
Free 套餐: 1,000 个一次性试用 credits = 以 6h 间隔监控 5 个 URL 一个月
Hobby 套餐: 5,000 credits = 以 6h 间隔监控 25 个 URL($19/mo)
Professional 套餐: 50,000 credits = 以 6h 间隔监控 250 个 URL($99/mo)