简介

Firecrawl API 参考（v2）

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

​

功能

Scrape

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

Crawl

爬取整个网站，提取其内容和元数据。

Map

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

Search

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

​

Agent 功能

Agent

自动导航网页并提取结构化数据。

Browser

创建并控制浏览器会话，以执行交互式 Web 任务。

​

基础 URL

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

https://api.firecrawl.dev

​

身份验证

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

Authorization: Bearer fc-YOUR-API-KEY

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

cURL

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 代码表示服务器错误。

Status	Description
200	请求成功。
400	请求参数无效。
401	缺少 API key 或 API key 无效。
402	需要付费。
404	未找到请求的资源。
429	超出速率限制。
5xx	Firecrawl 端的服务器错误。

当发生 5xx 错误时，响应体中会包含一个特定的错误码，帮助你诊断问题。

​

速率限制

Firecrawl API 会对所有端点实施速率限制，以确保服务稳定。速率限制是基于特定时间窗口内的请求数量设定的。

当你超过速率限制时，API 会返回 429 状态码。请在短暂延迟后再重试该请求。