Executar Código no Navegador

POST

browser

{sessionId}

execute

Executar código em uma sessão 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."
}

Cabeçalhos

Cabeçalho	Valor
`Authorization`	`Bearer <API_KEY>`
`Content-Type`	`application/json`

Corpo da requisição

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
`code`	string	Sim	-	Código a ser executado (1-100.000 caracteres)
`language`	string	Não	`"node"`	Idioma do código: `"python"`, `"node"` ou `"bash"` (para comandos de CLI do agent-browser)
`timeout`	number	Não	-	Tempo máximo de execução em segundos (1-300)

Resposta

Campo	Tipo	Descrição
`success`	boolean	Indica se o código foi executado com sucesso
`stdout`	string	Saída padrão da execução do código
`result`	string	Saída padrão da execução do código
`stderr`	string	Saída de erro padrão da execução do código
`exitCode`	number	Código de saída do processo executado
`killed`	boolean	Indica se o processo foi finalizado por tempo limite (timeout)
`error`	string	Mensagem de erro caso a execução falhe (apenas em caso de falha)

Exemplo de requisição

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

Exemplo de resposta (sucesso)

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

Exemplo de resposta (erro)

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

Autorizações

Authorization

string

header

obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parâmetros de caminho

sessionId

string

obrigatório

ID da sessão do navegador

Corpo

application/json

code

string

obrigatório

Código a ser executado no sandbox do navegador

Required string length: 1 - 100000

language

enum<string>

padrão:node

Linguagem do código a ser executado. Use node para JavaScript ou bash para comandos da CLI do agent-browser.

Opções disponíveis:

python,

node,

bash

timeout

integer

Tempo máximo de execução, em segundos

Intervalo obrigatório: 1 <= x <= 300

Resposta

Código executado com sucesso

success

boolean

stdout

string | null

Saída padrão da execução do código

result

string | null

Saída padrão (também conhecida como stdout)

stderr

string | null

Saída de erro padrão da execução do código

exitCode

integer | null

Código de saída do processo executado

killed

boolean

Indica se o processo foi encerrado por tempo limite excedido (timeout)

error

string | null

Mensagem de erro caso o código tenha gerado uma exceção

Executar código em uma sessão 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."
}

Usando a API

Endpoints de scraping

Endpoints de pesquisa

Endpoints de mapeamento

Endpoints de rastreamento

Endpoints de navegador

Endpoints de agente

Endpoints de extração

Endpoints de conta

Cabeçalhos

Corpo da requisição

Resposta

Exemplo de requisição

Exemplo de resposta (sucesso)

Exemplo de resposta (erro)

Autorizações

Parâmetros de caminho

Corpo

Resposta

​Cabeçalhos

​Corpo da requisição

​Resposta

​Exemplo de requisição

​Exemplo de resposta (sucesso)

​Exemplo de resposta (erro)

Autorizações

Parâmetros de caminho

Corpo

Resposta

Cabeçalhos

Corpo da requisição

Resposta

Exemplo de requisição

Exemplo de resposta (sucesso)

Exemplo de resposta (erro)