Saltar al contenido principal
POST
/
browser
/
{sessionId}
/
execute
Ejecutar código en una sesión de navegador
curl --request POST \
  --url https://api.firecrawl.dev/v2/browser/{sessionId}/execute \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "code": "<string>",
  "language": "node",
  "timeout": 150
}
'
{
  "success": true,
  "stdout": "<string>",
  "result": "<string>",
  "stderr": "<string>",
  "exitCode": 123,
  "killed": true,
  "error": "<string>"
}

​
Cabeceras

CabeceraValor
AuthorizationBearer <API_KEY>
Content-Typeapplication/json

​
Cuerpo de la solicitud

ParámetroTipoObligatorioPredeterminadoDescripción
codestringSí-Código a ejecutar (1-100,000 caracteres)
languagestringNo"node"Idioma del código: "python", "node" o "bash" (para comandos CLI de agent-browser)
timeoutnumberNo-Tiempo máximo de ejecución en segundos (1-300)

​
Respuesta

CampoTipoDescripción
successbooleanIndica si el código se ejecutó correctamente
stdoutstringSalida estándar de la ejecución del código
resultstringResultado estándar de la ejecución del código
stderrstringSalida de error estándar de la ejecución del código
exitCodenumberCódigo de salida del proceso ejecutado
killedbooleanIndica si el proceso se terminó por exceder el tiempo de espera
errorstringMensaje de error si la ejecución falló (solo presente en caso de error)

​
Ejemplo de solicitud

curl -X POST "https://api.firecrawl.dev/v2/browser/550e8400-e29b-41d4-a716-446655440000/execute" \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "await page.goto(\"https://example.com\")\ntitle = await page.title()\nprint(title)",
    "language": "python"
  }'

​
Ejemplo de respuesta (Éxito)

{
  "success": true,
  "result": "Example Domain"
}

​
Ejemplo de respuesta (error)

{
  "success": true,
  "error": "TimeoutError: page.goto: Timeout 30000ms exceeded."
}

Autorizaciones

​
Authorization
string
header
requerido

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

Parámetros de ruta

​
sessionId
string
requerido

ID de la sesión del navegador

Cuerpo

application/json
​
code
string
requerido

Código que se ejecutará en el entorno aislado del navegador

Required string length: 1 - 100000
​
language
enum<string>
predeterminado:node

Lenguaje del código que se va a ejecutar. Usa node para JavaScript o bash para comandos CLI de agent-browser.

Opciones disponibles:
python,
node,
bash
​
timeout
integer

Tiempo máximo de ejecución en segundos

Rango requerido: 1 <= x <= 300

Respuesta

Código ejecutado con éxito

​
success
boolean
​
stdout
string | null

Salida estándar de la ejecución del código

​
result
string | null

Salida estándar (stdout)

​
stderr
string | null

Salida de error estándar de la ejecución del código

​
exitCode
integer | null

Código de salida del proceso ejecutado

​
killed
boolean

Indica si el proceso terminó por tiempo de espera (timeout)

​
error
string | null

Mensaje de error si el código generó una excepción