Passer au contenu principal
POST
/
interact
/
{sessionId}
/
execute
Exécuter du code dans une session Interact
curl --request POST \
  --url https://api.firecrawl.dev/v2/interact/{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
}

​
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/interact/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.

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 Interact

Corps

application/json
​
code
string
requis

Code à exécuter dans le browser sandbox

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 agent-browser.

Options disponibles:
python,
node,
bash
​
timeout
integer

Délai d’expiration de l’exécution, en secondes

Plage requise: 1 <= x <= 300

Réponse

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 en raison du délai d’expiration

​
result
string | null

Sortie standard (alias de 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