Saltar al contenido principal
POST
/
browser
Crear una sesión de navegador
curl --request POST \
  --url https://api.firecrawl.dev/v2/browser \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ttl": 300,
  "activityTtl": 1805,
  "streamWebView": true
}
'
{
  "success": true,
  "id": "<string>",
  "cdpUrl": "<string>",
  "liveViewUrl": "<string>",
  "expiresAt": "2023-11-07T05:31:56Z"
}

​
Cabeceras

CabeceraValor
AuthorizationBearer <API_KEY>
Content-Typeapplication/json

​
Cuerpo de la solicitud

ParámetroTipoObligatorioValor predeterminadoDescripción
ttlnumberNo300Duración total de la sesión en segundos (30-3600)
activityTtlnumberNo60Segundos de inactividad antes de que la sesión se elimine (10-3600)

​
Respuesta

CampoTipoDescripción
successbooleanIndica si se creó la sesión
idstringIdentificador único de la sesión
cdpUrlstringURL de WebSocket para conexiones CDP
liveViewUrlstringURL para ver la sesión en tiempo real
expiresAtstringMomento en que la sesión expirará según el TTL

​
Ejemplo de solicitud

curl -X POST "https://api.firecrawl.dev/v2/browser" \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ttl": 120
  }'

​
Ejemplo de respuesta

{
  "success": true,
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "cdpUrl": "wss://cdp-proxy.firecrawl.dev/cdp/550e8400-e29b-41d4-a716-446655440000",
  "liveViewUrl": "https://liveview.firecrawl.dev/550e8400-e29b-41d4-a716-446655440000"
}

Autorizaciones

​
Authorization
string
header
requerido

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

Cuerpo

application/json
​
ttl
integer
predeterminado:300

Tiempo de vida total de la sesión de navegador, en segundos

Rango requerido: 30 <= x <= 3600
​
activityTtl
integer

Tiempo en segundos antes de que la sesión se destruya por inactividad

Rango requerido: 10 <= x <= 3600
​
streamWebView
boolean
predeterminado:true

Indica si se debe transmitir una vista en tiempo real del navegador

Respuesta

Sesión de navegador creada correctamente

​
success
boolean
​
id
string

Identificador único de la sesión

​
cdpUrl
string

URL de WebSocket para acceder al protocolo Chrome DevTools

​
liveViewUrl
string

URL para visualizar la sesión del navegador en tiempo real

​
expiresAt
string<date-time>

Momento en que la sesión expirará según el TTL