Crawl Page

Webhook event sent for each page scraped during a crawl job.

WEBHOOK crawlPage

Example

{
  "success": true,
  "type": "crawl.page",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "webhookId": "a1b2c3d4-0002-0000-0000-000000000000",
  "data": [
    {
      "markdown": "# Example Page\n\nThis is the page content.",
      "metadata": {
        "title": "Example Page",
        "description": "An example page.",
        "sourceURL": "https://example.com/page",
        "statusCode": 200
      }
    }
  ],
  "metadata": {}
}

For payload examples, configuration, and retry behavior, see Webhook Event Types and Webhook Overview.

Headers

X-Firecrawl-Signature · string

HMAC-SHA256 signature of the raw request body, formatted as sha256=<hex>. Present when an HMAC secret is configured in your account settings. See Webhook Security for verification details.

Example:

"sha256=abc123def456789..."

Body

application/json

success · boolean · required

true if the page was scraped successfully, false otherwise.

type · string · required

The event type.

Allowed value: "crawl.page"

id · string<uuid> · required

The crawl job ID.

webhookId · string<uuid> · required

Unique identifier for this webhook delivery.

data · object[] · required

Array containing the scraped page document. Same shape as the data field in the GET /scrape response.

Show child attributes

error · string

Error message if the page failed to scrape.

metadata · object

The custom metadata object you provided in the webhook configuration. Echoed back in every delivery.

Show child attributes

Response

200

Return any 2xx status code to acknowledge receipt.