Status Support Sign Up176k

简介

Firecrawl API 参考（v2）

1 min read

Note

**对于 AI 代理：**使用 llms.txt 查看所有文档的完整索引。

Firecrawl API 为你提供以编程方式访问 Web 数据的能力。所有端点共享同一个基础 URL、身份验证机制和响应格式，详见本页。

功能#

搜索全网，并以任意格式获取完整页面内容。

以 markdown 或 json 格式从任意网页提取内容。

创建交互会话，以点击、填写表单和浏览页面。

上传文件并将其解析为 markdown 或其他格式。

设置定期检查，并在内容发生变化时接收通知。

爬取整个网站，并获取所有页面的内容。

快速、可靠地获取任意网站的完整 URL 列表。

由 AI 驱动的自主网页数据收集。

基础 URL#

所有请求都使用以下基础 URL：

https://api.firecrawl.dev

身份验证#

每个请求都必须在 Authorization 请求头中包含你的 API 密钥：

Authorization: Bearer fc-YOUR-API-KEY

在所有 API 调用中都要包含这个请求头。你可以在 Firecrawl 控制台中找到你的 API 密钥。

如果你是没有 API 密钥的代理，请先查看获取凭据。如果你的平台支持 WorkOS ID-JAG，请使用 auth.md 中的注册说明。

curl -X POST "https://api.firecrawl.dev/v2/scrape" \  -H "Authorization: Bearer fc-YOUR-API-KEY" \  -H "Content-Type: application/json" \  -d '{"url": "https://example.com"}'

响应代码#

Firecrawl 使用标准的 HTTP 状态码来指示请求的结果。2xx 范围内的代码表示成功，4xx 代码表示客户端错误，5xx 代码表示服务器错误。

请参见错误了解完整参考，其中包括每种失败模式返回的 error 字符串、重试指导以及可直接复制粘贴的 backoff 代码片段。

429 响应#

当你超出当前套餐的请求速率或并发限制时，API 会返回 429 状态码。请参见 Rate Limits 了解各套餐的限制，并请参见 Errors 获取重试指南。