メインコンテンツへスキップ
キー制限を使うと、1つのAPIキーで利用できる出力フォーマットとエンドポイントを、あらかじめ定義した範囲に限定できます。これらの制限は認証時にサーバー側で適用されるため、制限付きキーを使ったリクエストが別のフラグを渡して制限を回避することはできません。つまり、リクエスト単位で上書きする方法はありません。 これは、APIキーを自動化エージェントや信頼できない呼び出し元に渡す環境で、そのキーにできることを厳密に保証したい場合を想定した機能です。たとえば、Markdown出力のみを許可しておけば、そのキーがraw HTMLやスクリプトの取得に使われることはありません。
キー制限はエンタープライズ向け機能で、組織ごとに有効化されます。ご利用のアカウントで有効にするには、Firecrawlのアカウント担当チームにお問い合わせください。

​
制限できる項目

各キーには、互いに独立した 2 つの許可リストがあります。
  • 許可されたフォーマット — キーがリクエストできる出力フォーマット (例: markdown) です。設定すると、キーはリスト内のフォーマットのみをリクエストできます。
  • 許可されたエンドポイント — キーが呼び出せるエンドポイントのグループ (例: scrape、crawl) です。設定すると、キーはそれらのグループ内のエンドポイントのみを呼び出せます。
各リストは、空でない場合にのみ適用されます。空のリストはその項目では「制限なし」を意味するため、両方のリストが空のキーは通常のキーとまったく同じように動作します。つまり、設定が空だからといってキーが使えなくなることはありません。

​
キーの設定

チーム管理者は、ダッシュボードの API Keys ページ から制限を設定できます。
  1. 制限を設定したいキーの ⋯ メニューを開き、Restrictions を選択します。
  2. 許可するフォーマットやエンドポイントを選択します。セクション内で何も選択しない場合、その項目には制限が適用されません。
  3. Save します。キーに Restricted バッジが表示され、変更は約1分で反映されます。
制限を表示または変更できるのは、チーム管理者のみです。

​
フォーマットの制限

キーに許可されたフォーマットのリストがある場合、スクレイピング結果を返すすべてのエンドポイントでその制限が適用されます: /v2/scrape、/v2/batch/scrape、/v2/crawl (scrapeOptions 経由) 、/v2/search (scrapeOptions 経由) 、およびそれらの v1 相当です。 リストに含まれていないフォーマットを指定したリクエストは拒否されます: 
{
  "success": false,
  "error": "Request blocked: this API key is restricted to the following formats: markdown. Requested formats not allowed: rawHtml. Team admins can manage key restrictions at https://www.firecrawl.dev/app/settings?tab=advanced"
}

​
コンテンツを返すアクション

一部のアクションは、formats フィールド経由ではなく、ページのコンテンツを直接返します。該当するのは screenshot、scrape、executeJavascript、pdf です。フォーマット制限付きのキーでは、これらは対応するフォーマットと同等のものとして扱われます。
  • screenshot アクションは、許可されたフォーマットの一覧に screenshot が含まれている場合にのみ許可されます。
  • scrape、executeJavascript、pdf アクションには対応するフォーマットがないため、フォーマット制限付きのキーでは常に拒否されます。
操作のみを行うアクション (wait、click、write、press、scroll) は影響を受けません。

​
エンドポイントの制限

キーに allowed-endpoints のリストが設定されている場合、そのグループ内のエンドポイントのみ呼び出せます。それ以外のエンドポイントへのリクエストは、認証時に 403 で拒否されます。 
{
  "success": false,
  "error": "Request blocked: this API key is restricted to the following endpoints: scrape. Team admins can manage key restrictions at https://www.firecrawl.dev/app/settings?tab=advanced"
}
利用可能なエンドポイントグループ: scrape, batch-scrape, crawl, map, search, extract, agent, parse, browser, monitor, research, llmstxt, deep-research, fireclaw. 許可リストを運用しやすくするために、いくつかルールがあります:
  • ジョブのステータス確認とキャンセルは、そのジョブタイプと同じグループに含まれます。 たとえば crawl が許可されている場合、GET /v2/crawl/{id} (ステータス) 、クロールの Errors エンドポイント、キャンセルもすべて許可されます — 個別に列挙する必要はありません。
  • アカウントおよびメタデータのエンドポイントには常にアクセスできます (例: /v2/team/*, /v2/concurrency-check) 。そのため、許可リストに関係なく SDK の内部管理は引き続き機能します。
  • 内部でスクレイピングを行うエンドポイントは、それぞれ自身のグループで制御されます。 extract と agent は処理の一部としてページを取得するため、許可リストに extract / agent が必要です — scrape だけを許可しても利用できません。

​
旧来の v0 API

旧来の v0 API はこれらの制御が導入される前のものであるため、何らかの 制限が設定されたキーでは使用できず、403 が返されます。代わりに v2 API を使用してください。

​
エラー一覧

ステータス該当するケース
403リクエストされたフォーマットが、そのキーの allowed-formats リストに含まれていません。
403フォーマット制限付きのキーで、コンテンツを返すアクションが使用されています。
403エンドポイントが、そのキーの allowed-endpoints リストに含まれていません。
403制限付きキーが旧来の v0 API を呼び出しています。
500制限構成を検証できませんでした。リクエストは制限をバイパスせず、フェイルクローズ (拒否) されます。少し待ってから再試行してください。

​
注意事項

  • 制限はキーごとに適用されるため、対話的な利用向けには無制限のキーを保持したまま、エージェント には制限付きのキーを渡せます。
  • 変更は約 1 分で API に反映されます。リクエスト内から適用を無効にすることはできません。
  • キー制限は IP 制限 とは独立しており、1 つのキーに両方を設定できます。