# パートナー連携API (/ja/partner-integration)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1461 · updated: 2026-07-30 -->
Related: [課金](/ja/billing.md), [レート制限](/ja/rate-limits.md), [パートナークレジット](/ja/partner-credits.md), [Enterprise](/ja/enterprise.md), [概要](/ja/dashboard.md), [スキル + CLI](/ja/sdks/cli.md)

<div id="overview">
  ## 概要 [#概要]
</div>

Firecrawl パートナー連携API を使うと、承認済みパートナーは自社プラットフォーム内から直接、ユーザー向けの Firecrawl APIキーを作成・管理できます。これにより、ユーザーはパートナーのプラットフォームを離れることなく Firecrawl の利用を開始でき、シームレスなオンボーディングを実現できます。

<Note>
  Partner API へのアクセスは、**承認済みの Firecrawl パートナーのみ**に提供されます。パートナーキーは、承認済みパートナーにのみ非公開で共有されます。パートナープログラムへの申請、またはパートナー APIキーのリクエストは、[partnerships@firecrawl.dev](mailto:partnerships@firecrawl.dev) までメールでご連絡ください。
</Note>

クレジット、有効期限、プランの上限など、パートナーユーザーに付与される内容の詳細については、[Partner Credits](/ja/partner-credits) を参照してください。

<div id="base-url">
  ## ベース URL [#ベース-url]
</div>

```
https://integrations.firecrawl.dev
```

<div id="authentication">
  ## 認証 [#認証]
</div>

すべての パートナー連携API リクエストには、パートナーキーを含む `Authorization` ヘッダーが必要です。

```bash
Authorization: Bearer <partner key>
```

パートナーキーは通常のFirecrawl APIキーとは異なり、Firecrawlチームから直接提供されます。

<div id="security-requirements">
  ## セキュリティ要件 [#セキュリティ要件]
</div>

* **サーバーサイドのみ**: パートナーキーは、サーバーサイドのコードでのみ使用してください。フロントエンドのコード、クライアントサイドの JavaScript、モバイルアプリケーションでは、パートナーキーを決して公開しないでください。
* **利用規約**: `POST /partner/v1/accounts` を呼び出す前に、ユーザーに Firecrawl の[利用規約](https://www.firecrawl.dev/terms-of-service)への同意を求める必要があります。

***

<div id="endpoints">
  ## エンドポイント [#エンドポイント]
</div>

<div id="create-user">
  ### ユーザーを作成 [#ユーザーを作成]
</div>

ユーザーのメールアドレスに紐づくFirecrawl APIキーを作成します。

```
POST /partner/v1/accounts
```

<div id="behavior">
  #### 挙動 [#挙動]
</div>

* ユーザーがまだ Firecrawl アカウントを持っていない場合は、新しいユーザーとチームが作成されます。
* ユーザーがすでに Firecrawl アカウントを持っていても、パートナー連携に関連付けられたチームがない場合は、新しいパートナー連携用のチームが作成されます。
* ユーザーがすでに Firecrawl アカウントを持っており、パートナー連携に関連付けられたチームもすでにある場合は、既存のチームが返され、プロモーションクーポンは **再適用されません**。

<div id="request">
  #### リクエスト [#リクエスト]
</div>

```bash title="cURL"
curl -X POST "https://integrations.firecrawl.dev/partner/v1/accounts" \
  -H "Authorization: Bearer <partner key>" \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com"}'
```

**ボディ**

| フィールド   | 型      | 必須 | 説明           |
| ------- | ------ | -- | ------------ |
| `email` | string | はい | ユーザーのメールアドレス |

<div id="response">
  #### レスポンス [#レスポンス]
</div>

**`200 OK`**

```json
{
  "apiKey": "fc-...",
  "alreadyExisted": false
}
```

| フィールド            | 型       | 説明                                                                            |
| ---------------- | ------- | ----------------------------------------------------------------------------- |
| `apiKey`         | string  | このユーザーのパートナーに関連付けられたチームの Firecrawl APIキー                                      |
| `alreadyExisted` | boolean | ユーザーとパートナーに関連付けられたチームの両方がすでに存在していた場合は `true`。`true` の場合、プロモーションクーポンは再適用されません。 |

<div id="errors">
  #### エラー [#エラー]
</div>

| ステータス | 説明                                        |
| ----- | ----------------------------------------- |
| `401` | 認証されていません - パートナーキーが誤っているか無効です            |
| `500` | サーバー内部エラー - これらのエラーは Firecrawl 側で監視されています |

***

<div id="validate-api-key">
  ### APIキーの検証 [#apiキーの検証]
</div>

Firecrawl APIキーを検証し、関連するチーム名とユーザーのメールアドレスを返します。APIキーが有効と判定されるのは、このパートナー連携を通じて作成された場合に限られます。

```
POST /partner/v1/api-keys/validate
```

<div id="important-notes">
  #### 重要な注意点 [#重要な注意点]
</div>

* Firecrawl APIキーには権限設定や有効期限がありません。
* APIキーは、ユーザーがいつでも手動で削除できます。
* 削除されたAPIキーはソフトデリートされません。Firecrawlでは、削除されたキーと、そもそも存在しなかったキーを区別できません。

<div id="request">
  #### リクエスト [#リクエスト-1]
</div>

```bash title="cURL"
curl -X POST "https://integrations.firecrawl.dev/partner/v1/api-keys/validate" \
  -H "Authorization: Bearer <partner key>" \
  -H "Content-Type: application/json" \
  -d '{"apiKey": "fc-..."}'
```

**ボディ**

| フィールド    | 型      | 必須 | 説明           |
| -------- | ------ | -- | ------------ |
| `apiKey` | string | はい | 検証対象の API キー |

<div id="response">
  #### レスポンス [#レスポンス-1]
</div>

**`200 OK`**

```json
{
  "teamName": "Example Team",
  "email": "user@example.com"
}
```

| フィールド      | タイプ    | 説明                          |
| ---------- | ------ | --------------------------- |
| `teamName` | string | このAPIキーに関連付けられたチーム名         |
| `email`    | string | このAPIキーに関連付けられたユーザーのメールアドレス |

<div id="errors">
  #### エラー [#エラー-1]
</div>

| ステータス | 説明                                                 |
| ----- | -------------------------------------------------- |
| `401` | 未認証 - パートナーキーが誤っているか無効です                           |
| `404` | API key を特定できません - キーが存在しないか、このパートナー連携経由で作成されていません |
| `500` | 内部サーバーエラー - これらのエラーは Firecrawl 側で監視されています          |

***

<div id="rotate-api-key">
  ### APIキーを再発行 [#apiキーを再発行]
</div>

既存のFirecrawl APIキーを削除し、同じユーザーとチーム向けに新しいキーを作成します。

```
POST /partner/v1/api-keys/rotate
```

<div id="request">
  #### リクエスト [#リクエスト-2]
</div>

```bash title="cURL"
curl -X POST "https://integrations.firecrawl.dev/partner/v1/api-keys/rotate" \
  -H "Authorization: Bearer <partner key>" \
  -H "Content-Type: application/json" \
  -d '{"apiKey": "fc-..."}'
```

**ボディ**

| フィールド    | 型      | 必須 | 説明                     |
| -------- | ------ | -- | ---------------------- |
| `apiKey` | string | はい | 削除して新しいものに置き換える API キー |

<div id="response">
  #### レスポンス [#レスポンス-2]
</div>

**`200 OK`**

```json
{
  "apiKey": "fc-..."
}
```

| フィールド    | 型      | 説明            |
| -------- | ------ | ------------- |
| `apiKey` | string | 新しく作成されたAPIキー |

<div id="errors">
  #### エラー [#エラー-2]
</div>

| ステータス | 説明                                                 |
| ----- | -------------------------------------------------- |
| `401` | 未認証 - パートナーキーが誤っているか無効です                           |
| `404` | API key を特定できません - キーが存在しないか、このパートナー連携経由で作成されていません |
| `500` | 内部サーバーエラー - これらのエラーは Firecrawl 側で監視されています          |

***

<div id="become-a-partner">
  ## パートナーになる [#パートナーになる]
</div>

Firecrawlのパートナープログラムは、承認済みのプラットフォーム向けに提供されています。ご自身のプラットフォームにFirecrawlを統合し、ユーザーにクレジットを提供することにご関心がある場合は、詳細の確認やパートナー向けAPIキーの申請について [partnerships@firecrawl.dev](mailto:partnerships@firecrawl.dev) までお問い合わせください。