# 简介 (/zh/api-reference/v2-introduction)
Related: [错误](/zh/api-reference/errors.md), [合作伙伴集成 API](/zh/partner-integration.md)
\*\*对于 AI 代理：\*\*使用 [llms.txt](/zh/llms.txt) 查看所有文档的完整索引。
Firecrawl API 为你提供以编程方式访问 Web 数据的能力。所有端点共享同一个基础 URL、身份验证机制和响应格式，详见本页。
## 功能 [#功能]
以 markdown 或 json 格式从任意网页提取内容。
上传文件并将其解析为 markdown 或其他格式。
爬取整个网站，并获取所有页面的内容。
快速、可靠地获取任意网站的完整 URL 列表。
搜索全网，并以任意格式获取完整页面内容。
## Agent 功能 [#agent-功能]
由 AI 驱动的自主网页数据采集。
创建并控制浏览器会话，以执行交互式 Web 任务。
## 基础 URL [#基础-url]
所有请求都使用以下基础 URL：
```bash
https://api.firecrawl.dev
```
## 身份验证 [#身份验证]
每个请求都必须在 `Authorization` 请求头中包含你的 API 密钥：
```bash
Authorization: Bearer fc-YOUR-API-KEY
```
在所有 API 调用中都要包含这个请求头。你可以在 [Firecrawl 控制台](https://www.firecrawl.dev/app/api-keys) 中找到你的 API 密钥。
如果你是没有 API 密钥的代理，请先查看[获取凭据](/zh/ai-onboarding#get-credentials)。如果你的平台支持 WorkOS ID-JAG，请使用 [`auth.md`](https://www.firecrawl.dev/auth.md) 中的注册说明。
cURL
Python
Node
```bash
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"}'
```
```python
from firecrawl import Firecrawl
firecrawl = Firecrawl(api_key="fc-YOUR-API-KEY")
result = firecrawl.scrape("https://example.com")
```
```js
import { Firecrawl } from 'firecrawl';
const firecrawl = new Firecrawl({ apiKey: "fc-YOUR-API-KEY" });
const result = await firecrawl.scrape('https://example.com');
```
## 响应代码 [#响应代码]
Firecrawl 使用标准的 HTTP 状态码来指示请求的结果。`2xx` 范围内的代码表示成功，`4xx` 代码表示客户端错误，`5xx` 代码表示服务器错误。
请参见[错误](/zh/api-reference/errors)了解完整参考，其中包括每种失败模式返回的 `error` 字符串、重试指导以及可直接复制粘贴的 backoff 代码片段。
## 429 响应 [#429-响应]
当你超出当前套餐的请求速率或并发限制时，API 会返回 `429` 状态码。请参见 [Rate Limits](/zh/rate-limits) 了解各套餐的限制，并请参见 [Errors](/zh/api-reference/errors) 获取重试指南。