Pular para o conteúdo principal
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."
}

Autorizações

​
Authorization
string
header
obrigatório

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

Parâmetros de caminho

​
sessionId
string
obrigatório

ID da sessão do navegador

Corpo

application/json
​
code
string
obrigatório

Código a ser executado no sandbox do navegador

Required string length: 1 - 100000
​
language
enum<string>
padrão:node

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

Opções disponíveis:
python,
node,
bash
​
timeout
integer

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

Intervalo obrigatório: 1 <= x <= 300

Resposta

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