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,
  "profile": {
    "name": "<string>",
    "saveChanges": true
  }
}
'
{
  "success": true,
  "id": "<string>",
  "cdpUrl": "<string>",
  "liveViewUrl": "<string>",
  "interactiveLiveViewUrl": "<string>",
  "expiresAt": "2023-11-07T05:31:56Z"
}

​
Cabeceras

CabeceraValor
AuthorizationBearer <API_KEY>
Content-Typeapplication/json

​
Cuerpo de la solicitud

ParámetroTipoObligatorioValor predeterminadoDescripción
ttlnumberNo600Duración total de la sesión en segundos (30-3600)
activityTtlnumberNo300Segundos de inactividad antes de que la sesión se elimine (10-3600)
profileobjectNo—Habilita el almacenamiento persistente entre sesiones. Consulta más abajo.
profile.namestringSí*—Nombre del perfil (1-128 caracteres). Las sesiones con el mismo nombre comparten almacenamiento.
profile.saveChangesbooleanNotrueCuando es true, el estado del navegador se guarda de nuevo en el perfil al cerrar. Establécelo en false para cargar los datos existentes sin escribir. Solo se permite un proceso de guardado a la vez.

​
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
interactiveLiveViewUrlstringURL para interactuar con la sesión en tiempo real (hacer clic, escribir, desplazarse)
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",
  "interactiveLiveViewUrl": "https://liveview.firecrawl.dev/550e8400-e29b-41d4-a716-446655440000?interactive=true"
}

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

​
profile
object

Habilita el almacenamiento de datos persistente entre sesiones del navegador. Los datos guardados en una sesión se pueden volver a cargar en una sesión posterior usando el mismo nombre.

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

​
interactiveLiveViewUrl
string

URL para interactuar en tiempo real con la sesión del navegador (clics, escritura, desplazamiento)

​
expiresAt
string<date-time>

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