列出浏览器会话

检索所有浏览器会话的列表，并可选地按状态进行过滤。

GET /browser

列出浏览器会话

cURL

curl --request GET \
  --url https://api.firecrawl.dev/v2/browser \
  --header 'Authorization: Bearer <token>'

200

{
  "success": true,
  "sessions": [
    {
      "id": "<string>",
      "cdpUrl": "<string>",
      "liveViewUrl": "<string>",
      "interactiveLiveViewUrl": "<string>",
      "streamWebView": true,
      "createdAt": "2023-11-07T05:31:56Z",
      "lastActivity": "2023-11-07T05:31:56Z"
    }
  ]
}

​

请求头

请求头	值
Authorization	Bearer <API_KEY>

​

查询参数

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

​

响应

字段	类型	描述
success	boolean	请求是否成功
sessions	array	会话对象列表

​

会话对象

字段	类型	描述
id	string	唯一会话标识符
status	string	当前会话状态（"active" 或 "destroyed"）
cdpUrl	string	用于 CDP 连接的 WebSocket URL
liveViewUrl	string	实时查看会话的 URL
interactiveLiveViewUrl	string	实时与会话交互（点击、输入、滚动）的 URL
createdAt	string	会话创建时的 ISO 8601 时间戳
lastActivity	string	上次活动的 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",
      "interactiveLiveViewUrl": "https://liveview.firecrawl.dev/550e8400-e29b-41d4-a716-446655440000?interactive=true",
      "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

响应

200

application/json

浏览会话列表

success · boolean

sessions · object[]

Show child attributes