はじめに

Firecrawl API リファレンス（v2）

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

​

機能

Scrape

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

Parse

ファイルをアップロードし、markdown またはその他のフォーマットに変換します。

Crawl

ウェブサイト全体をクロールし、すべてのページのコンテンツを取得します。

Map

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

Search

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

​

エージェント機能

Agent

AI による自律的な Web データ収集。

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 番台のコードはサーバーエラーを示します。

各障害モードで返される error 文字列、再試行のガイダンス、コピー＆ペーストして使える backoff スニペットを含む完全なリファレンスについては、Errors を参照してください。

​

レート制限

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

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