- 明示的に指定したURLのリストを対象とする点を除き、
/crawlと同様に動作します - 同期モードと非同期モードに対応
- 構造化抽出を含む、すべてのスクレイピングオプションをサポート
- ジョブごとに同時実行数を設定可能
仕組み
基本的な使い方
レスポンス
batchScrape / batch_scrape を呼び出すと、バッチ完了時に完全な結果が返されます。
完了
startBatchScrape / start_batch_scrape を呼び出すと、getBatchScrapeStatus / get_batch_scrape_status、API エンドポイント /batch/scrape/{id}、または Webhook を使って追跡できるジョブ ID が返されます。ジョブの結果は、完了後 24 時間まで API 経由で取得できます。この期間を過ぎても、activity logs からバッチスクレイプの履歴と結果を確認できます。
並行実行数
maxConcurrency パラメータでジョブごとにこの上限を下げることができます。
たとえば、maxConcurrency: 50 とすると、そのジョブは同時に 50 件までしかスクレイプを実行しません。大規模なバッチでこの値を低くしすぎると処理が大幅に遅くなるため、他のジョブ用に同時実行枠を残す必要がある場合にのみ減らしてください。
構造化抽出
レスポンス
batchScrape / batch_scrape は完全な結果を返します:
完了
startBatchScrape / start_batch_scrape はジョブ ID を返します:
Webhooks
cURL
イベントの種類
ペイロード
Webhook シグネチャの検証
X-Firecrawl-Signature ヘッダーが含まれます。Webhook が正当なものであり、改ざんされていないことを確認するために、必ずこのシグネチャを検証してください。
- アカウント設定の Advanced タブ から webhook secret を取得する
X-Firecrawl-Signatureヘッダーからシグネチャを取り出す- secret を使って、生のリクエストボディに対して HMAC-SHA256 を計算する
- タイミング攻撃耐性のある (タイミングセーフな) 関数を用いて、計算結果とシグネチャヘッダーを比較する
Firecrawl API key が必要な AI agent の方は、自動オンボーディング手順について firecrawl.dev/agent-onboarding/SKILL.md を参照してください。

