| 400 | Bad Request / バリデーションエラーメッセージ | リクエストボディのスキーマ検証に失敗しました (フィールドの欠落または不正) 。 | エンドポイントのリファレンスを参照し、リクエストペイロードを修正してください。該当するフィールドは details で確認できます。 | いいえ |
| 400 | Invalid URL | url フィールドが指定されていない、形式が不正である、またはサポートされていないスキームが使用されています。 | http(s):// で始まる絶対 URL を指定してください。 | いいえ |
| 400 | THIRD_PARTY_DATA_UNSUPPORTED_URL | このURLはサードパーティのデータプロバイダーが提供するサイトのものですが、プロバイダーが提供するのはレコード自体のページ (プロフィールページなど) のみで、その配下のサブページには対応していません。レスポンスの code にはこの値が設定されます。 | 配下のサブページや出品ページではなく、レコード自体のページをスクレイピングしてください。 | 不可 |
| 400 | THIRD_PARTY_DATA_UNSUPPORTED_OPTION | この URL(LinkedIn のプロフィールなど)はサードパーティのデータプロバイダー経由でのみ取得できますが、リクエストにプロバイダーが対応していないオプションが指定されています。対象となるのは actions、profile、minAge、zeroDataRetention、lockdown、redactPII、または screenshot や branding などの未対応のフォーマットです。error には該当するオプション名が示されます。レスポンスの code にはこの値が入ります。 | そのオプションを外してリクエストを送信してください。Team のポリシーでゼロデータ保持が必須になっている場合、これらの URL は処理できません。詳しくは プロバイダー経由で処理される URL を参照してください。 | いいえ |
| 401 | Unauthorized: Invalid token | APIキーが指定されていないか、形式が正しくないか、失効しています。 | ダッシュボードで取得した有効なキーを使って、Authorization: Bearer fc-... ヘッダーを送信してください。 | 不可 |
| 402 | Payment Required: Insufficient credits | プランのクレジットが不足しているか、課金設定が完了していません。 | 従量課金を有効にするか、プランをアップグレードしてください。 | 不可 |
| 403 | Forbidden | キーにこのエンドポイントまたは機能へのアクセス権限がありません。 | 必要なスコープを持つキーを使用するか、この機能を利用できる上位プランにアップグレードしてください。 | いいえ |
| 403 | SCRAPE_PROMPT_INJECTION_DETECTED | checkPromptInjection オプションにより、スクレイピングしたページのコンテンツからプロンプトインジェクションの試みが検出されたため、スクレイピングが中止されました。 | ページのコンテンツを手動で確認してください。誤検知の場合は、checkPromptInjection を指定せずにリトライしてください。詳しくはプロンプトインジェクションの検出を参照してください。 | 不可 |
| 403 | THIRD_PARTY_DATA_NOT_ENABLED | このURLに対応するサードパーティデータプロバイダーが、組織で有効になっていません (組織の管理者が無効にした場合など) 。レスポンスの code にはこの値が入ります。 | 組織の管理者に依頼して、該当プロバイダーの Alexandria ページから有効化してもらうか、エンリッチメントプロバイダーから削除してください。 | 有効化後に可能 |
| 403 | THIRD_PARTY_DATA_ENRICHMENT_NOT_ENABLED | URL が LinkedIn のプロフィールまたは企業ページですが、その種類のプロフィールではエンリッチメントが無効になっているか、保存済みのエンリッチメントプロバイダーのいずれもこの URL に対応していません。レスポンスの code にはこの値が入り、error にはエンリッチメント設定へのリンクが含まれます。 | 組織の管理者に依頼して、エンリッチメント設定でエンリッチメントを有効にし、プロバイダーを選択してもらってください。詳しくはプロバイダー経由でルーティングされるURLを参照してください。 | セットアップ後 |
| 403 | We apologize for the inconvenience but we do not support this site... / UNSUPPORTED_SITE | Firecrawl はこのサイトのスクレイピングに対応しておらず、この URL を扱えるサードパーティのデータプロバイダーもありません。一部のレスポンスでは、code にも UNSUPPORTED_SITE が設定されます。 | このデータは別の取得元から取得してください。Enterpriseをご利用のお客様は、このサイトについて営業担当にお問い合わせいただけます。 | いいえ |
| 403 | THIRD_PARTY_DATA_TERMS_REQUIRED | リクエストを実行するには、Alexandria のプロバイダーが定める利用規約に組織が同意する必要があります。プロバイダーは実行されていません。レスポンスの code にはこの値が設定され、requiresAction.url も含まれます。 | requiresAction.url を組織の管理者に共有し、管理者がそのページで規約を確認して同意してください。エージェントが独断で規約に同意してはいけません。同意後、同じリクエストを再送信してください。 | 規約への同意後 |
| 404 | Not Found | ジョブ ID、リソース、またはエンドポイントのパスが存在しません。 | リソース ID とエンドポイント URL を確認してください。 | 不可 |
| 404 | THIRD_PARTY_DATA_NOT_FOUND | このURLはサードパーティのデータプロバイダーから提供されるものですが、いずれのプロバイダーにも該当するレコードが存在しません。複数のエンリッチメントプロバイダーを利用している場合は、すべてのプロバイダーで照会済みです。レコードが見つからなかったプロバイダーの料金は発生しません。レスポンスの code にはこの値が返されます。 | URLが実在するプロフィールページまたは企業ページを指していることを確認してください。データ拡充プロバイダーを追加すると、対応範囲が広がる可能性があります。 | いいえ |
| 408 | Request Timeout | ページの読み込みが、リクエストの timeout で指定された時間内に完了しませんでした。 | timeout を延ばすか、アクションを簡素化するか、fastMode を使用してください。 | はい (バックオフを適用) |
| 409 | Conflict | リソースがオペレーションを実行できない状態にあります (例:すでに削除済み) 。 | リトライする前に状態を再取得し、整合性を確保してください。 | 不可 |
| 413 | Payload Too Large | リクエストボディが許容される最大サイズを超えています。 | ペイロードを小さくしてください (例:スキーマを短くする、バッチあたりのURL数を減らす) 。 | 不可 |
| 422 | Unprocessable Entity / 抽出スキーマエラー | スキーマが有効なJSON Schemaではないか、モデルがスキーマに準拠した結果を生成できませんでした。 | スキーマを検証する、必須フィールドを減らす、別の model を試す、などの対処を行ってください。 | 場合による |
| 429 | Rate limit exceeded | プランの1分あたりのリクエスト上限を超えています。 | リクエストを一時停止し、Retry-After で示された秒数だけ待ってからリトライしてください。詳しくは Rate Limits を参照してください。 | はい、バックオフが必要 |
| 429 | Concurrency limit reached | プランのブラウザー同時実行数の上限に達しました。 | 実行中のjobが完了するまで待つか、同時実行数を減らすか、プランをアップグレードしてください。 | 可能 (バックオフを適用) |
| 500 | Internal Server Error | サーバー側で未処理の障害が発生。 | 指数バックオフでリトライしてください。問題が続く場合は、request IDを添えてサポートにお問い合わせください。 | 可能 (バックオフを適用) |
| 502 | Bad Gateway | 上流のプロキシまたはワーカーが無効なレスポンスを返しました。 | バックオフを適用してリトライしてください。 | 可能 (バックオフを適用) |
| 503 | Service Unavailable | サービスが一時的にリクエストを処理できない状態です。 | バックオフを適用してリトライしてください。 | はい (バックオフを適用) |
| 504 | Gateway Timeout | リクエストがゲートウェイのタイムアウト時間を超えました (通常は長時間のクロールが原因です) 。 | 代わりに非同期クロール/バッチのエンドポイントを使用し、ステータスをポーリングしてください。 | 可能 (バックオフを適用) |