Passer au contenu principal
POST
/
browser
/
{sessionId}
/
execute
Exécuter du code dans une session de navigateur
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>"
}

​
En-têtes

En-têteValeur
AuthorizationBearer <API_KEY>
Content-Typeapplication/json

​
Corps de la requête

ParamètreTypeObligatoireValeur par défautDescription
codestringOui-Code à exécuter (1-100 000 caractères)
languagestringNon"node"Langage du code : "python", "node" ou "bash" (pour les commandes CLI d’agent-browser)
timeoutnumberNon-Durée maximale d’exécution en secondes (1-300)

​
Réponse

ChampTypeDescription
successbooleanIndique si le code s’est exécuté avec succès
stdoutstringSortie standard de l’exécution du code
resultstringSortie standard de l’exécution du code
stderrstringSortie d’erreur standard de l’exécution du code
exitCodenumberCode de sortie du processus exécuté
killedbooleanIndique si le processus a été interrompu en raison d’un dépassement de délai
errorstringMessage d’erreur si l’exécution a échoué (présent uniquement en cas d’échec)

​
Exemple de requête

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

​
Exemple de réponse (réussite)

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

​
Exemple de réponse (erreur)

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

Autorisations

​
Authorization
string
header
requis

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

Paramètres de chemin

​
sessionId
string
requis

ID de la session de navigateur

Corps

application/json
​
code
string
requis

Code à exécuter dans l’environnement isolé (sandbox) du navigateur

Required string length: 1 - 100000
​
language
enum<string>
défaut:node

Langage du code à exécuter. Utilisez node pour JavaScript ou bash pour les commandes CLI d’agent-browser.

Options disponibles:
python,
node,
bash
​
timeout
integer

Délai d’exécution maximal en secondes

Plage requise: 1 <= x <= 300

Réponse

Code exécuté avec succès

​
success
boolean
​
stdout
string | null

Sortie standard de l’exécution du code

​
result
string | null

Sortie standard (alias stdout)

​
stderr
string | null

Sortie d’erreur standard de l’exécution du code

​
exitCode
integer | null

Code de sortie du processus exécuté

​
killed
boolean

Indique si le processus a été interrompu pour dépassement du temps limite

​
error
string | null

Message d’erreur si le code a déclenché une exception