Listar sessões de navegador

Obtenha uma lista de todas as sessões de navegador, com filtro opcional por status.

GET /browser

Listar sessões 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"
    }
  ]
}

​

Cabeçalhos

Cabeçalho	Valor
Authorization	Bearer <API_KEY>

​

Parâmetros de query

Parâmetro	Tipo	Obrigatório	Descrição
status	string	Não	Filtra pelo status da sessão: "active" ou "destroyed"

​

Resposta

Campo	Tipo	Descrição
success	boolean	Indica se a requisição foi bem-sucedida
sessions	array	Lista de objetos de sessão

​

Objeto de sessão

Campo	Tipo	Descrição
id	string	Identificador único da sessão
status	string	Status atual da sessão ("active" ou "destroyed")
cdpUrl	string	URL de WebSocket para conexões CDP
liveViewUrl	string	URL para assistir à sessão em tempo real
interactiveLiveViewUrl	string	URL para interagir com a sessão em tempo real (clicar, digitar, rolar)
createdAt	string	Carimbo de data e hora ISO 8601 da criação da sessão
lastActivity	string	Carimbo de data e hora ISO 8601 da última atividade

​

Exemplo de requisição

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

​

Exemplo de resposta

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

Autorizações

Authorization · string · header · obrigatório

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

Parâmetros de consulta

status · enum<string>

Filtrar sessões por status

Opções disponíveis: active, destroyed

Resposta

200

application/json

Lista de sessões do navegador

success · boolean

sessions · object[]

Show child attributes