Documentation Index
Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
Use this file to discover all available pages before exploring further.
Firecrawl パートナー連携API を使うと、承認済みパートナーは自社プラットフォーム内から直接、ユーザー向けの Firecrawl APIキーを作成・管理できます。これにより、ユーザーはパートナーのプラットフォームを離れることなく Firecrawl の利用を開始でき、シームレスなオンボーディングを実現できます。
Partner API へのアクセスは、承認済みの Firecrawl パートナーのみに提供されます。パートナーキーは、承認済みパートナーにのみ非公開で共有されます。パートナープログラムへの申請、またはパートナー APIキーのリクエストは、partnerships@firecrawl.dev までメールでご連絡ください。
クレジット、有効期限、プランの上限など、パートナーユーザーに付与される内容の詳細については、Partner Credits を参照してください。
https://api.firecrawl.dev
すべての パートナー連携API リクエストには、パートナーキーを含む Authorization ヘッダーが必要です。
Authorization: Bearer <partner key>
パートナーキーは通常のFirecrawl APIキーとは異なり、Firecrawlチームから直接提供されます。
- サーバーサイドのみ: パートナーキーは、サーバーサイドのコードでのみ使用してください。フロントエンドのコード、クライアントサイドの JavaScript、モバイルアプリケーションでは、パートナーキーを決して公開しないでください。
- 利用規約: create-user エンドポイントを呼び出す前に、ユーザーに Firecrawl の利用規約への同意を求める必要があります。
ユーザーのメールアドレスに紐づくFirecrawl APIキーを作成します。
POST /admin/integration/create-user
- ユーザーがまだ Firecrawl アカウントを持っていない場合は、新しいユーザーとチームが作成されます。
- ユーザーがすでに Firecrawl アカウントを持っていても、パートナー連携に関連付けられたチームがない場合は、新しいパートナー連携用のチームが作成されます。
- ユーザーがすでに Firecrawl アカウントを持っており、パートナー連携に関連付けられたチームもすでにある場合は、既存のチームが返され、プロモーションクーポンは 再適用されません。
curl -X POST "https://api.firecrawl.dev/admin/integration/create-user" \
-H "Authorization: Bearer <partner key>" \
-H "Content-Type: application/json" \
-d '{"email": "user@example.com"}'
ボディ
| フィールド | 型 | 必須 | 説明 |
|---|
email | string | はい | ユーザーのメールアドレス |
200 OK
{
"apiKey": "fc-...",
"alreadyExisted": false
}
| フィールド | 型 | 説明 |
|---|
apiKey | string | このユーザーのパートナーに関連付けられたチームの Firecrawl APIキー |
alreadyExisted | boolean | ユーザーとパートナーに関連付けられたチームの両方がすでに存在していた場合は true。true の場合、プロモーションクーポンは再適用されません。 |
| ステータス | 説明 |
|---|
401 | 認証されていません - パートナーキーが誤っているか無効です |
500 | サーバー内部エラー - これらのエラーは Firecrawl 側で監視されています |
Firecrawl APIキーを検証し、関連するチーム名とユーザーのメールアドレスを返します。APIキーが有効と判定されるのは、このパートナー連携を通じて作成された場合に限られます。
POST /admin/integration/validate-api-key
- Firecrawl APIキーには権限設定や有効期限がありません。
- APIキーは、ユーザーがいつでも手動で削除できます。
- 削除されたAPIキーはソフトデリートされません。Firecrawlでは、削除されたキーと、そもそも存在しなかったキーを区別できません。
curl -X POST "https://api.firecrawl.dev/admin/integration/validate-api-key" \
-H "Authorization: Bearer <partner key>" \
-H "Content-Type: application/json" \
-d '{"apiKey": "fc-..."}'
ボディ
| フィールド | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | 検証対象の API キー |
200 OK
{
"teamName": "Example Team",
"email": "user@example.com"
}
| フィールド | タイプ | 説明 |
|---|
teamName | string | このAPIキーに関連付けられたチーム名 |
email | string | このAPIキーに関連付けられたユーザーのメールアドレス |
| ステータス | 説明 |
|---|
401 | 認証エラー - パートナーキーが正しくないか、無効です |
404 | APIキーを識別できません - キーが存在しないか、このパートナー連携経由で作成されていません |
500 | 内部サーバーエラー - これらのエラーは Firecrawl によって監視されています |
既存のFirecrawl APIキーを削除し、同じユーザーとチーム向けに新しいキーを作成します。
POST /admin/integration/rotate-api-key
curl -X POST "https://api.firecrawl.dev/admin/integration/rotate-api-key" \
-H "Authorization: Bearer <partner key>" \
-H "Content-Type: application/json" \
-d '{"apiKey": "fc-..."}'
ボディ
| フィールド | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | 削除して新しいものに置き換える API キー |
200 OK
| フィールド | 型 | 説明 |
|---|
apiKey | string | 新しく作成されたAPIキー |
| ステータス | 説明 |
|---|
401 | 未認証 - パートナーキーが誤っているか無効です |
404 | API key を特定できません - キーが存在しないか、このパートナー連携経由で作成されていません |
500 | 内部サーバーエラー - これらのエラーは Firecrawl 側で監視されています |
Firecrawlのパートナープログラムは、承認済みのプラットフォーム向けに提供されています。ご自身のプラットフォームにFirecrawlを統合し、ユーザーにクレジットを提供することにご関心がある場合は、詳細の確認やパートナー向けAPIキーの申請について partnerships@firecrawl.dev までお問い合わせください。