Exécuter du code dans le navigateur

POST

browser

{sessionId}

execute

Exécuter du code dans une session de navigateur

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

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

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 de navigateur

Corps

application/json

code

string

requis

Code à exécuter dans l’environnement isolé (sandbox) du navigateur

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

Options disponibles:

python,

node,

bash

timeout

integer

Délai d’exécution maximal en secondes

Plage requise: 1 <= x <= 300

Réponse

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

Exécuter du code dans une session de navigateur

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

Utilisation de l’API

Points de terminaison pour le scraping

Points de terminaison pour la recherche

Points de terminaison pour la cartographie

Points de terminaison pour l’exploration

Points de terminaison pour le navigateur

Points de terminaison pour les agents

Points de terminaison pour l’extraction

Points de terminaison pour le compte

En-têtes

Corps de la requête

Réponse

Exemple de requête

Exemple de réponse (réussite)

Exemple de réponse (erreur)

Autorisations

Paramètres de chemin

Corps

Réponse

​En-têtes

​Corps de la requête

​Réponse

​Exemple de requête

​Exemple de réponse (réussite)

​Exemple de réponse (erreur)

Autorisations

Paramètres de chemin

Corps

Réponse

En-têtes

Corps de la requête

Réponse

Exemple de requête

Exemple de réponse (réussite)

Exemple de réponse (erreur)