Ejecutar código en el navegador

Ejecutar código en una sesión de navegador

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

import requests

url = "https://api.firecrawl.dev/v2/browser/{sessionId}/execute"

payload = {
    "code": "<string>",
    "language": "node",
    "timeout": 150
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({code: '<string>', language: 'node', timeout: 150})
};

fetch('https://api.firecrawl.dev/v2/browser/{sessionId}/execute', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.firecrawl.dev/v2/browser/{sessionId}/execute",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'code' => '<string>',
    'language' => 'node',
    'timeout' => 150
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.firecrawl.dev/v2/browser/{sessionId}/execute"

	payload := strings.NewReader("{\n  \"code\": \"<string>\",\n  \"language\": \"node\",\n  \"timeout\": 150\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.firecrawl.dev/v2/browser/{sessionId}/execute")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"code\": \"<string>\",\n  \"language\": \"node\",\n  \"timeout\": 150\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.firecrawl.dev/v2/browser/{sessionId}/execute")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"code\": \"<string>\",\n  \"language\": \"node\",\n  \"timeout\": 150\n}"

response = http.request(request)
puts response.read_body

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

{
  "error": "Payment required to access this resource."
}

POST

browser

{sessionId}

execute

Ejecutar código en una sesión de navegador

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

import requests

url = "https://api.firecrawl.dev/v2/browser/{sessionId}/execute"

payload = {
    "code": "<string>",
    "language": "node",
    "timeout": 150
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({code: '<string>', language: 'node', timeout: 150})
};

fetch('https://api.firecrawl.dev/v2/browser/{sessionId}/execute', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.firecrawl.dev/v2/browser/{sessionId}/execute",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'code' => '<string>',
    'language' => 'node',
    'timeout' => 150
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.firecrawl.dev/v2/browser/{sessionId}/execute"

	payload := strings.NewReader("{\n  \"code\": \"<string>\",\n  \"language\": \"node\",\n  \"timeout\": 150\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.firecrawl.dev/v2/browser/{sessionId}/execute")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"code\": \"<string>\",\n  \"language\": \"node\",\n  \"timeout\": 150\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.firecrawl.dev/v2/browser/{sessionId}/execute")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"code\": \"<string>\",\n  \"language\": \"node\",\n  \"timeout\": 150\n}"

response = http.request(request)
puts response.read_body

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

{
  "error": "Payment required to access this resource."
}

Cabeceras

Cabecera	Valor
`Authorization`	`Bearer <API_KEY>`
`Content-Type`	`application/json`

Cuerpo de la solicitud

Parámetro	Tipo	Obligatorio	Predeterminado	Descripción
`code`	string	Sí	-	Código a ejecutar (1-100,000 caracteres)
`language`	string	No	`"node"`	Idioma del código: `"python"`, `"node"` o `"bash"` (para comandos CLI de agent-browser)
`timeout`	number	No	-	Tiempo máximo de ejecución en segundos (1-300)

Respuesta

Campo	Tipo	Descripción
`success`	boolean	Indica si el código se ejecutó correctamente
`stdout`	string	Salida estándar de la ejecución del código
`result`	string	Resultado estándar de la ejecución del código
`stderr`	string	Salida de error estándar de la ejecución del código
`exitCode`	number	Código de salida del proceso ejecutado
`killed`	boolean	Indica si el proceso se terminó por exceder el tiempo de espera
`error`	string	Mensaje de error si la ejecución falló (solo presente en caso de error)

Ejemplo de solicitud

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

Ejemplo de respuesta (Éxito)

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

Ejemplo de respuesta (error)

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

¿Eres un agente de IA que necesita una clave de la API de Firecrawl? Consulta firecrawl.dev/agent-onboarding/SKILL.md para ver las instrucciones de incorporación automatizada.

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 sesión del navegador

Body

application/json

code

string

required

Código que se ejecutará en el entorno aislado del navegador

Required string length: 1 - 100000

language

enum<string>

default:node

Lenguaje del código que se va a ejecutar. Usa node para JavaScript o bash para comandos CLI de agent-browser.

Available options:

python,

node,

bash

timeout

integer

Tiempo máximo de ejecución en segundos

Required range: 1 <= x <= 300

Response

Código ejecutado con éxito

success

boolean

stdout

string | null

Salida estándar de la ejecución del código

result

string | null

Salida estándar (stdout)

stderr

string | null

Salida de error estándar de la ejecución del código

exitCode

integer | null

Código de salida del proceso ejecutado

killed

boolean

Indica si el proceso terminó por tiempo de espera (timeout)

error

string | null

Mensaje de error si el código generó una excepción

Get Started

Core Endpoints

More

Quickstarts

Developer Guides

Webhooks

Use Cases

Dashboard

Contributing

Ejecutar código en el navegador

Cabeceras

Cuerpo de la solicitud

Respuesta

Ejemplo de solicitud

Ejemplo de respuesta (Éxito)

Ejemplo de respuesta (error)

Authorizations

Path Parameters

Body

Response

​Cabeceras

​Cuerpo de la solicitud

​Respuesta

​Ejemplo de solicitud

​Ejemplo de respuesta (Éxito)

​Ejemplo de respuesta (error)

Authorizations

Path Parameters

Body

Response

Cabeceras

Cuerpo de la solicitud

Respuesta

Ejemplo de solicitud

Ejemplo de respuesta (Éxito)

Ejemplo de respuesta (error)