はじめに

Firecrawl API リファレンス（v2）

Firecrawl API を使用すると、プログラムから Web データにアクセスできます。すべてのエンドポイントは、本ページで説明する共通のベース URL、認証方式、レスポンス形式を使用します。

​

機能

Scrape

任意のウェブページから、markdown または json のフォーマットでコンテンツを抽出します。

Crawl

ウェブサイト全体をクロールし、コンテンツとメタデータを抽出します。

Map

任意のウェブサイトから URL の一覧を迅速かつ高い信頼性で取得します。

Search

ウェブを検索し、任意のフォーマットでページ全体のコンテンツを取得します。

​

エージェント機能

Agent

ウェブサイトを自律的に巡回し、構造化データを抽出します。

Browser

インタラクティブな Web タスク向けにブラウザセッションを作成・制御します。

​

ベースURL

すべてのリクエストは次のベースURLを使用します：

https://api.firecrawl.dev

​

認証

すべてのリクエストには API キーを指定した Authorization ヘッダーが必要です：

Authorization: Bearer fc-YOUR-API-KEY

すべての API 呼び出しにこのヘッダーを含めてください。API キーは Firecrawl ダッシュボード で確認できます。

cURL

curl -X POST "https://api.firecrawl.dev/v2/scrape" \
  -H "Authorization: Bearer fc-YOUR-API-KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

​

レスポンスコード

Firecrawl は、リクエストの結果を示すために標準的な HTTP ステータスコードを使用します。2xx 番台のコードは成功、4xx 番台のコードはクライアントエラー、5xx 番台のコードはサーバーエラーを示します。

Status	説明
200	リクエストは成功しました。
400	無効なリクエストパラメータです。
401	API キーが未設定か無効です。
402	支払いが必要です。
404	要求されたリソースが見つかりませんでした。
429	レート制限を超過しました。
5xx	Firecrawl 側でサーバーエラーが発生しました。

5xx エラーが発生した場合、レスポンスボディには問題の診断に役立つ特定のエラーコードが含まれます。

​

レート制限

Firecrawl API は、サービスの安定性を確保するため、すべてのエンドポイントに対してレート制限を適用しています。レート制限は、一定時間内のリクエスト数に基づいて決まります。

レート制限を超過した場合、API は 429 ステータスコードを返します。短時間待ってから、リクエストを再試行してください。