Skip to main content
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
}
'
{
  "error": "<string>",
  "exitCode": 123,
  "killed": true,
  "result": "<string>",
  "stderr": "<string>",
  "stdout": "<string>",
  "success": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
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."
}
Êtes-vous un agent d’IA qui a besoin d’une clé API Firecrawl ? Consultez firecrawl.dev/agent-onboarding/SKILL.md pour obtenir des instructions d’intégration automatisée.

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 de la session de navigateur

Body

application/json
​
code
string
required

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

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

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

Available options:
python,
node,
bash
​
timeout
integer

Délai d’exécution maximal en secondes

Required range: 1 <= x <= 300

Response

Code exécuté avec succès

​
error
string | null

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

​
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

​
result
string | null

Sortie standard (alias stdout)

​
stderr
string | null

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

​
stdout
string | null

Sortie standard de l’exécution du code

​
success
boolean