ヘッダー
| ヘッダー | 値 |
|---|---|
Content-Type | application/json |
リクエストボディ
| Parameter | Type | 必須 | 説明 |
|---|---|---|---|
email | string | はい | 人間のスポンサーのメールアドレスです。有効なメールアドレスである必要があります。 |
agent_name | string | はい | キーを作成するagentの名前です (1～100文字) 。確認メールに表示されます。 |
accept_terms | boolean | はい | true である必要があります。利用規約への同意を示します。 |
レスポンス
| フィールド | 型 | 説明 |
|---|---|---|
success | boolean | キーが作成されたかどうか |
api_key | string | 発行されたAPI key (fc-で始まる) |
sponsor_status | string | 作成時は常に"pending" |
credit_limit | number | 確認前に利用できる最大credits (50) |
credits_remaining | number | 残りのcredits (作成時は50) |
verification_deadline_at | string | ISO 8601形式のタイムスタンプ。スポンサーはこの期限 (5日以内) までに確認する必要があります。 |
tos_url | string | 同意済みの利用規約のURL |
リクエスト例
curl -X POST "https://api.firecrawl.dev/v2/agent-signup" \
-H "Content-Type: application/json" \
-d '{
"email": "user@company.com",
"agent_name": "Research Assistant",
"accept_terms": true
}'
レスポンス例
{
"success": true,
"api_key": "fc-abc123...",
"sponsor_status": "pending",
"credit_limit": 50,
"credits_remaining": 50,
"verification_deadline_at": "2026-03-23T12:00:00.000Z",
"tos_url": "https://firecrawl.dev/terms-of-service"
}
エラーレスポンス
| ステータス | エラー | 発生時 |
|---|---|---|
400 | 無効なリクエストボディ | 必須フィールドが不足しているか、無効です |
403 | このemailではAgent登録がブロックされています | スポンサーが以前にAgent登録をブロックしました |
403 | 前回のAgent登録確認の有効期限が切れています | 前回の登録の有効期限が切れているため、スポンサーはログインする必要があります |
409 | 保留中のAgent登録確認がすでに送信されています | このemailには、保留中のキーがすでにあります |