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

​
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/interact/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."
}
¿Eres un agente de IA que necesita una clave de la API de Firecrawl? Consulta firecrawl.dev/agent-onboarding/SKILL.md para ver las instrucciones de incorporación automatizada.

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

El ID de la sesión de interact

Cuerpo

application/json
​
code
string
requerido

Código que se ejecutará en el sandbox del navegador

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

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

Opciones disponibles:
python,
node,
bash
​
timeout
integer

Tiempo de espera de ejecución en segundos

Rango requerido: 1 <= x <= 300

Respuesta

Código ejecutado correctamente

​
error
string | null

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

​
exitCode
integer | null

Código de salida del proceso ejecutado

​
killed
boolean

Si el proceso fue finalizado por tiempo de espera

​
result
string | null

Salida estándar (alias de stdout)

​
stderr
string | null

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

​
stdout
string | null

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

​
success
boolean