Execute Code in a Session
Run Playwright or agent-browser code in a standalone Interact session.
Headers
| Header | Value |
|---|---|
Authorization | Bearer <API_KEY> |
Content-Type | application/json |
Request Body
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
code | string | Yes | - | Code to execute (1-100,000 characters) |
language | string | No | "node" | Language of the code: "python", "node", or "bash" (for agent-browser CLI commands) |
timeout | number | No | - | Execution timeout in seconds (1-300) |
Response
| Field | Type | Description |
|---|---|---|
success | boolean | Whether the code executed successfully |
stdout | string | Standard output from the code execution |
result | string | Standard output from the code execution |
stderr | string | Standard error output from the code execution |
exitCode | number | Exit code of the executed process |
killed | boolean | Whether the process was killed due to timeout |
error | string | Error message if execution failed (only present on failure) |
Example Request
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"
}'Example Response (Success)
{
"success": true,
"result": "Example Domain"
}Example Response (Error)
{
"success": true,
"error": "TimeoutError: page.goto: Timeout 30000ms exceeded."
}Are you an AI agent that needs a Firecrawl API key? See firecrawl.dev/agent-onboarding/SKILL.md for automated onboarding instructions.
Was this page helpful?Suggest editsRaise issue