# 页面监控 (/zh/api-reference/endpoint/webhook-monitor-page)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 1869 · updated: 2026-07-30 -->
Related: [Search（搜索）](/zh/api-reference/endpoint/search.md), [搜索反馈](/zh/api-reference/endpoint/search-feedback.md), [Scrape](/zh/api-reference/endpoint/scrape.md), [批量抓取](/zh/api-reference/endpoint/batch-scrape.md), [获取批量抓取状态](/zh/api-reference/endpoint/batch-scrape-get.md), [取消批量抓取](/zh/api-reference/endpoint/batch-scrape-delete.md)



`POST` webhook `monitorPage`

页面监控

## OpenAPI

```json
{
  "parameters": [
    {
      "description": "原始请求体的 HMAC-SHA256 签名，格式为 `sha256=<hex>`。当你在[账户设置](https://www.firecrawl.dev/app/settings?tab=advanced)中配置了 HMAC 密钥时，该字段会出现。有关验证详情，请参阅 [Webhook 安全](/webhooks/security)。",
      "in": "header",
      "name": "X-Firecrawl-Signature",
      "required": false,
      "schema": {
        "example": "sha256=abc123def456789...",
        "type": "string"
      }
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "example": {
          "data": [
            {
              "checkId": "019df960-5f2a-75fb-a98b-bd2d32ca67d4",
              "currentScrapeId": "019df960-73ee-7ac2-97a9-fb0e442c21f1",
              "diff": {
                "text": "--- previous\n+++ current\n@@ -1,3 +1,3 @@\n # Latest posts\n-Welcome to our weekly update.\n+Welcome to our weekly update — now with daily releases!\n"
              },
              "error": null,
              "isMeaningful": true,
              "judgment": {
                "confidence": "high",
                "meaningful": true,
                "meaningfulChanges": [
                  {
                    "after": "Welcome to our weekly update — now with daily releases!",
                    "before": "Welcome to our weekly update.",
                    "reason": "The headline changed in a way that matches the monitor goal.",
                    "type": "changed"
                  }
                ],
                "reason": "The page headline changed to announce a new release cadence."
              },
              "monitorId": "019df960-06e7-7383-9d89-82c0113dc31a",
              "previousScrapeId": "019df94f-82c3-7e41-81f0-00c72b2d9c52",
              "status": "changed",
              "url": "https://example.com/blog"
            }
          ],
          "id": "019df960-5f2a-75fb-a98b-bd2d32ca67d4",
          "metadata": {},
          "success": true,
          "type": "monitor.page",
          "webhookId": "f1e2d3c4-0000-0000-0000-000000000000"
        },
        "schema": {
          "properties": {
            "data": {
              "items": {
                "properties": {
                  "checkId": {
                    "description": "监控检查 ID。",
                    "format": "uuid",
                    "type": "string"
                  },
                  "currentScrapeId": {
                    "format": "uuid",
                    "nullable": true,
                    "type": "string"
                  },
                  "diff": {
                    "description": "已变更页面的内联差异。根据监控变更跟踪模式，可能包含 `text`、`json` 或两者。",
                    "nullable": true,
                    "properties": {
                      "json": {
                        "type": "object"
                      },
                      "text": {
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "error": {
                    "nullable": true,
                    "type": "string"
                  },
                  "isMeaningful": {
                    "description": "当已变更页面运行了有意义变更判断时，为 `true` 或 `false`；否则为 `null`。",
                    "nullable": true,
                    "type": "boolean"
                  },
                  "judgment": {
                    "nullable": true,
                    "properties": {
                      "confidence": {
                        "enum": [
                          "high",
                          "medium",
                          "low"
                        ],
                        "type": "string"
                      },
                      "meaningful": {
                        "type": "boolean"
                      },
                      "meaningfulChanges": {
                        "description": "由评判器从页面 diff 中选出的与目标相关的变更。",
                        "items": {
                          "properties": {
                            "after": {
                              "nullable": true,
                              "type": "string"
                            },
                            "before": {
                              "nullable": true,
                              "type": "string"
                            },
                            "reason": {
                              "type": "string"
                            },
                            "type": {
                              "enum": [
                                "added",
                                "removed",
                                "changed"
                              ],
                              "type": "string"
                            }
                          },
                          "type": "object"
                        },
                        "type": "array"
                      },
                      "reason": {
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "monitorId": {
                    "description": "监控 ID。",
                    "format": "uuid",
                    "type": "string"
                  },
                  "previousScrapeId": {
                    "format": "uuid",
                    "nullable": true,
                    "type": "string"
                  },
                  "status": {
                    "description": "此次抓取完成对应的页面级状态。",
                    "enum": [
                      "same",
                      "new",
                      "changed",
                      "error"
                    ],
                    "type": "string"
                  },
                  "url": {
                    "description": "页面 URL。",
                    "format": "uri",
                    "type": "string"
                  }
                },
                "required": [
                  "monitorId",
                  "checkId",
                  "url",
                  "status"
                ],
                "type": "object"
              },
              "type": "array"
            },
            "error": {
              "description": "监控页面失败时的错误消息。",
              "type": "string"
            },
            "id": {
              "description": "监控检查 ID。",
              "format": "uuid",
              "type": "string"
            },
            "metadata": {
              "additionalProperties": {
                "type": "string"
              },
              "description": "你在 webhook 配置中提供的自定义元数据对象。每次投递时都会原样返回。",
              "type": "object"
            },
            "success": {
              "description": "当页面抓取成功完成且未发生错误时，为 `true`。",
              "type": "boolean"
            },
            "type": {
              "const": "monitor.page",
              "description": "事件类型。",
              "type": "string"
            },
            "webhookId": {
              "description": "此次 webhook 投递的唯一标识符。",
              "format": "uuid",
              "type": "string"
            }
          },
          "required": [
            "success",
            "type",
            "id",
            "webhookId",
            "data"
          ],
          "type": "object"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "description": "返回任意 `2xx` 状态码以确认已接收。"
    }
  }
}
```