Listar sesiones del navegador

Obtén una lista de todas las sesiones del navegador, con opción de filtrarlas por estado.

GET /browser

Listar sesiones de navegador

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"
    }
  ]
}

​

Cabeceras

Cabecera	Valor
Authorization	Bearer <API_KEY>

​

Parámetros de consulta

Parámetro	Tipo	Requerido	Descripción
status	string	No	Filtra por el estado de la sesión: "active" o "destroyed"

​

Respuesta

Campo	Tipo	Descripción
success	boolean	Indica si la petición se realizó correctamente
sessions	array	Lista de objetos de sesión

​

Objeto de sesión

Campo	Tipo	Descripción
id	string	Identificador único de sesión
status	string	Estado actual de la sesión ("active" o "destroyed")
cdpUrl	string	URL de WebSocket para conexiones CDP
liveViewUrl	string	URL para ver la sesión en tiempo real
interactiveLiveViewUrl	string	URL para interactuar con la sesión en tiempo real (hacer clic, escribir, desplazarse)
createdAt	string	Marca de tiempo ISO 8601 de la creación de la sesión
lastActivity	string	Marca de tiempo ISO 8601 de la última actividad

​

Ejemplo de solicitud

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

​

Ejemplo de respuesta

{
  "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"
    }
  ]
}

Autorizaciones

Authorization · string · header · requerido

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

Parámetros de consulta

status · enum<string>

Filtrar sesiones por estado

Opciones disponibles: active, destroyed

Respuesta

200

application/json

Lista de sesiones del navegador

success · boolean

sessions · object[]

Show child attributes