| 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 字段为此值。 | 发送请求时请去掉该选项。如果你的团队策略强制启用零数据保留,则无法处理这些 URL。请参见由提供商路由的 URL。 | 否 |
| 401 | Unauthorized: Invalid token | API 密钥缺失、格式错误或已被撤销。 | 请求时发送 Authorization: Bearer fc-...,并使用从 Dashboard 获取的有效密钥。 | 否 |
| 402 | Payment Required: Insufficient credits | 方案额度已用尽,或尚未配置计费。 | 启用按量付费,或升级您的方案。 | 否 |
| 403 | Forbidden | 密钥没有访问此端点或功能的权限。 | 使用具备所需权限范围的密钥,或升级方案以解锁此功能。 | 否 |
| 403 | SCRAPE_PROMPT_INJECTION_DETECTED | checkPromptInjection 选项在抓取的页面内容中检测到 prompt 注入尝试,因此已中止抓取。 | 请手动检查页面内容。如确认为误报,请去掉 checkPromptInjection 后重试。请参见 Prompt injection 检测。 | 否 |
| 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。 | 请从其他来源获取此数据。企业客户可联系销售团队,咨询该站点的支持情况。 | 否 |
| 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 由第三方数据提供商提供数据,但所有提供商均无该 URL 的记录。若配置了多个数据增强提供商,则已逐一尝试。无记录的提供商不收取任何费用。响应中的 code 字段即为此值。 | 确认 URL 指向的个人资料页或公司页面确实存在。添加更多数据增强提供商可以提高覆盖率。 | 否 |
| 408 | Request Timeout | 页面加载耗时超出了请求设置的 timeout。 | 调大 timeout、简化 actions,或使用 fastMode。 | 可以,但需采用退避策略 |
| 409 | Conflict | 资源当前的状态不允许执行该操作 (例如已被删除) 。 | 重试前,重新获取状态并解决状态冲突。 | 否 |
| 413 | Payload Too Large | 请求体大小超出了允许的上限。 | 减小负载 (例如精简 schema、减少每批次的 URL 数量) 。 | 否 |
| 422 | Unprocessable Entity / 提取 schema 错误 | 模式不符合 JSON Schema 规范,或模型无法生成符合该模式的结果。 | 校验 schema;减少必填字段;换用其他 model。 | 有时可以 |
| 429 | Rate limit exceeded | 请求数超过了您所用方案的每分钟限额。 | 暂停请求,等待 Retry-After 秒后重试。请参见限流。 | 是,需采用退避策略 |
| 429 | Concurrency limit reached | 已达到您所用方案的浏览器并发上限。 | 等待正在执行的任务完成、降低并发数,或升级您的方案。 | 是,需采用退避策略 |
| 500 | Internal Server Error | 服务器端发生未处理的故障。 | 采用指数退避策略重试。如果问题仍然存在,请联系支持团队并提供请求 ID。 | 是,需采用退避策略 |
| 502 | Bad Gateway | 上游代理或工作进程返回了无效响应。 | 采用退避策略重试。 | 是,采用退避策略 |
| 503 | Service Unavailable | 服务暂时无法处理请求。 | 采用退避策略重试。 | 是,需采用退避策略 |
| 504 | Gateway Timeout | 请求超过网关的超时时限 (通常由耗时较长的爬取导致) 。 | 改用异步爬取/批量处理端点,并轮询任务状态。 | 是,需采用退避策略 |