Pular para o conteúdo principal
GET
/
browser
Listar sessões de navegador
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"
    }
  ]
}

​
Cabeçalhos

CabeçalhoValor
AuthorizationBearer <API_KEY>

​
Parâmetros de query

ParâmetroTipoObrigatórioDescrição
statusstringNãoFiltra pelo status da sessão: "active" ou "destroyed"

​
Resposta

CampoTipoDescrição
successbooleanIndica se a requisição foi bem-sucedida
sessionsarrayLista de objetos de sessão

​
Objeto de sessão

CampoTipoDescrição
idstringIdentificador único da sessão
statusstringStatus atual da sessão ("active" ou "destroyed")
cdpUrlstringURL de WebSocket para conexões CDP
liveViewUrlstringURL para assistir à sessão em tempo real
createdAtstringCarimbo de data e hora ISO 8601 da criação da sessão
lastActivitystringCarimbo 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",
      "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

Lista de sessões do navegador

​
success
boolean
​
sessions
object[]