Skip to main content
POST
/
browser
/
{sessionId}
/
execute
Executar código em uma sessão 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>"
}

​
Cabeçalhos

CabeçalhoValor
AuthorizationBearer <API_KEY>
Content-Typeapplication/json

​
Corpo da requisição

ParâmetroTipoObrigatórioPadrãoDescrição
codestringSim-Código a ser executado (1-100.000 caracteres)
languagestringNão"node"Idioma do código: "python", "node" ou "bash" (para comandos de CLI do agent-browser)
timeoutnumberNão-Tempo máximo de execução em segundos (1-300)

​
Resposta

CampoTipoDescrição
successbooleanIndica se o código foi executado com sucesso
stdoutstringSaída padrão da execução do código
resultstringSaída padrão da execução do código
stderrstringSaída de erro padrão da execução do código
exitCodenumberCódigo de saída do processo executado
killedbooleanIndica se o processo foi finalizado por tempo limite (timeout)
errorstringMensagem de erro caso a execução falhe (apenas em caso de falha)

​
Exemplo de requisição

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"
  }'

​
Exemplo de resposta (sucesso)

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

​
Exemplo de resposta (erro)

{
  "success": true,
  "error": "TimeoutError: page.goto: Timeout 30000ms exceeded."
}
Você é um agente de IA que precisa de uma Firecrawl API key? Veja firecrawl.dev/agent-onboarding/SKILL.md para instruções de onboarding automatizado.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
sessionId
string
required

ID da sessão do navegador

Body

application/json
​
code
string
required

Código a ser executado no sandbox do navegador

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

Linguagem do código a ser executado. Use node para JavaScript ou bash para comandos da CLI do agent-browser.

Available options:
python,
node,
bash
​
timeout
integer

Tempo máximo de execução, em segundos

Required range: 1 <= x <= 300

Response

Código executado com sucesso

​
success
boolean
​
stdout
string | null

Saída padrão da execução do código

​
result
string | null

Saída padrão (também conhecida como stdout)

​
stderr
string | null

Saída de erro padrão da execução do código

​
exitCode
integer | null

Código de saída do processo executado

​
killed
boolean

Indica se o processo foi encerrado por tempo limite excedido (timeout)

​
error
string | null

Mensagem de erro caso o código tenha gerado uma exceção