# ページの一括スクレイピング (/ja/api-reference/endpoint/webhook-batch-scrape-page)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 1167 · updated: 2026-07-30 -->
Related: [検索](/ja/api-reference/endpoint/search.md), [検索フィードバック](/ja/api-reference/endpoint/search-feedback.md), [スクレイプ](/ja/api-reference/endpoint/scrape.md), [バッチスクレープ](/ja/api-reference/endpoint/batch-scrape.md), [バッチスクレイプのステータス取得](/ja/api-reference/endpoint/batch-scrape-get.md), [バッチスクレイプのキャンセル](/ja/api-reference/endpoint/batch-scrape-delete.md)

ペイロードの例、設定、再試行の挙動については、[Webhook Event Types](/ja/webhooks/events#batch_scrapepage) と [Webhook Overview](/ja/webhooks/overview) を参照してください。

`POST` webhook `batchScrapePage`

ページをバッチスクレイプ中

## OpenAPI

```json
{
  "parameters": [
    {
      "description": "生のリクエスト本文の HMAC-SHA256 署名。形式は `sha256=<hex>` です。[アカウント設定](https://www.firecrawl.dev/app/settings?tab=advanced)で HMAC シークレットが設定されている場合に含まれます。検証の詳細は [Webhook Security](/webhooks/security) を参照してください。",
      "in": "header",
      "name": "X-Firecrawl-Signature",
      "required": false,
      "schema": {
        "example": "sha256=abc123def456789...",
        "type": "string"
      }
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "example": {
          "data": [
            {
              "markdown": "# Example Page\n\nThis is the page content.",
              "metadata": {
                "description": "ページの例。",
                "sourceURL": "https://example.com",
                "statusCode": 200,
                "title": "Example Page"
              }
            }
          ],
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "metadata": {},
          "success": true,
          "type": "batch_scrape.page",
          "webhookId": "b2c3d4e5-0002-0000-0000-000000000000"
        },
        "schema": {
          "properties": {
            "data": {
              "description": "スクレイピングされたページドキュメントを含む配列。",
              "items": {
                "description": "スクレイピングされたページのドキュメント。scrape レスポンスの `data` オブジェクトと同じ構造です。",
                "properties": {
                  "html": {
                    "description": "ページの整形済み HTML コンテンツ。",
                    "type": "string"
                  },
                  "links": {
                    "description": "ページ上で検出された外部リンク。",
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "markdown": {
                    "description": "Markdown に変換されたページのコンテンツ。",
                    "type": "string"
                  },
                  "metadata": {
                    "description": "ページのメタデータ。",
                    "properties": {
                      "description": {
                        "description": "メタディスクリプション。",
                        "type": "string"
                      },
                      "sourceURL": {
                        "description": "スクレイピングされたページの URL。",
                        "type": "string"
                      },
                      "statusCode": {
                        "description": "レスポンスの HTTP ステータスコード。",
                        "type": "integer"
                      },
                      "title": {
                        "description": "ページの `<title>`。",
                        "type": "string"
                      }
                    },
                    "type": "object"
                  },
                  "rawHtml": {
                    "description": "処理前の元の HTML。",
                    "type": "string"
                  },
                  "screenshot": {
                    "description": "`screenshot` 形式が要求された場合の、Base64 エンコードされたスクリーンショット。",
                    "type": "string"
                  }
                },
                "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`、それ以外の場合は`false`。",
              "type": "boolean"
            },
            "type": {
              "const": "batch_scrape.page",
              "type": "string"
            },
            "webhookId": {
              "description": "このWebhook配信の一意の識別子。",
              "format": "uuid",
              "type": "string"
            }
          },
          "required": [
            "success",
            "type",
            "id",
            "webhookId",
            "data"
          ],
          "type": "object"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "description": "受信を確認するには、任意の`2xx`ステータスコードを返してください。"
    }
  }
}
```