Exécuter du code dans le navigateur

Exécutez du code dans un environnement de navigateur isolé (sandbox).

POST /browser/{sessionId}/execute

Exécuter du code dans une session de navigateur

cURL

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

200

{
  "success": true,
  "stdout": "<string>",
  "result": "<string>",
  "stderr": "<string>",
  "exitCode": 123,
  "killed": true,
  "error": "<string>"
}

En-têtes

En-tête	Valeur
Authorization	Bearer <API_KEY>
Content-Type	application/json

Corps de la requête

Paramètre	Type	Obligatoire	Valeur par défaut	Description
code	string	Oui	-	Code à exécuter (1-100 000 caractères)
language	string	Non	"node"	Langage du code : "python", "node" ou "bash" (pour les commandes CLI d’agent-browser)
timeout	number	Non	-	Durée maximale d’exécution en secondes (1-300)

Réponse

Champ	Type	Description
success	boolean	Indique si le code s’est exécuté avec succès
stdout	string	Sortie standard de l’exécution du code
result	string	Sortie standard de l’exécution du code
stderr	string	Sortie d’erreur standard de l’exécution du code
exitCode	number	Code de sortie du processus exécuté
killed	boolean	Indique si le processus a été interrompu en raison d’un dépassement de délai
error	string	Message 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

200

application/json

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