跳转到主要内容
GET
/
browser
列出浏览器会话
curl --request GET \
  --url https://api.firecrawl.dev/v2/browser \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "sessions": [
    {
      "id": "<string>",
      "status": "active",
      "cdpUrl": "<string>",
      "liveViewUrl": "<string>",
      "streamWebView": true,
      "createdAt": "2023-11-07T05:31:56Z",
      "lastActivity": "2023-11-07T05:31:56Z"
    }
  ]
}

​
请求头

请求头值
AuthorizationBearer <API_KEY>

​
查询参数

参数类型是否必填描述
statusstring否根据会话状态进行筛选："active" 或 "destroyed"

​
响应

字段类型描述
successboolean请求是否成功
sessionsarray会话对象列表

​
会话对象

字段类型描述
idstring唯一会话标识符
statusstring当前会话状态（"active" 或 "destroyed"）
cdpUrlstring用于 CDP 连接的 WebSocket URL
liveViewUrlstring实时查看会话的 URL
createdAtstring会话创建时的 ISO 8601 时间戳
lastActivitystring上次活动的 ISO 8601 时间戳

​
请求示例

curl -X GET "https://api.firecrawl.dev/v2/browser?status=active" \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY"

​
示例响应

{
  "success": true,
  "sessions": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "active",
      "cdpUrl": "wss://cdp-proxy.firecrawl.dev/cdp/550e8400-e29b-41d4-a716-446655440000",
      "liveViewUrl": "https://liveview.firecrawl.dev/550e8400-e29b-41d4-a716-446655440000",
      "createdAt": "2025-06-01T12:00:00Z",
      "lastActivity": "2025-06-01T12:05:30Z"
    }
  ]
}

授权

​
Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

查询参数

​
status
enum<string>

按状态筛选会话

可用选项:
active,
destroyed

响应

浏览会话列表

​
success
boolean
​
sessions
object[]