Passer au contenu principal
POST
/
browser
Créer une session de navigateur
curl --request POST \
  --url https://api.firecrawl.dev/v2/browser \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ttl": 300,
  "activityTtl": 1805,
  "streamWebView": true
}
'
{
  "success": true,
  "id": "<string>",
  "cdpUrl": "<string>",
  "liveViewUrl": "<string>",
  "expiresAt": "2023-11-07T05:31:56Z"
}

​
En-têtes

En-têteValeur
AuthorizationBearer <API_KEY>
Content-Typeapplication/json

​
Corps de la requête

ParamètreTypeObligatoireValeur par défautDescription
ttlnumberNon300Durée de vie totale de la session en secondes (30-3600)
activityTtlnumberNon60Nombre de secondes d’inactivité avant la destruction de la session (10-3600)

​
Réponse

ChampTypeDescription
successbooleanIndique si la session a bien été créée
idstringIdentifiant unique de la session
cdpUrlstringURL WebSocket pour les connexions CDP
liveViewUrlstringURL pour afficher la session en temps réel
expiresAtstringDate d’expiration de la session en fonction du TTL

​
Exemple de requête

curl -X POST "https://api.firecrawl.dev/v2/browser" \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ttl": 120
  }'

​
Exemple de réponse

{
  "success": true,
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "cdpUrl": "wss://cdp-proxy.firecrawl.dev/cdp/550e8400-e29b-41d4-a716-446655440000",
  "liveViewUrl": "https://liveview.firecrawl.dev/550e8400-e29b-41d4-a716-446655440000"
}

Autorisations

​
Authorization
string
header
requis

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

Corps

application/json
​
ttl
integer
défaut:300

Durée de vie totale de la session de navigateur, en secondes

Plage requise: 30 <= x <= 3600
​
activityTtl
integer

Temps en secondes avant la destruction de la session pour cause d’inactivité

Plage requise: 10 <= x <= 3600
​
streamWebView
boolean
défaut:true

Indique s’il faut diffuser un flux en direct du navigateur

Réponse

Session de navigateur créée avec succès

​
success
boolean
​
id
string

Identifiant unique de la session

​
cdpUrl
string

URL WebSocket pour accéder au protocole Chrome DevTools

​
liveViewUrl
string

URL permettant d’afficher la session de navigateur en temps réel

​
expiresAt
string<date-time>

Date et heure d’expiration de la session en fonction du TTL