Lister les sessions de navigateur

Obtenir la liste de toutes les sessions de navigateur, avec possibilité de filtrer par statut.

GET /browser

Lister les sessions de navigateur

cURL

curl --request GET \
  --url https://api.firecrawl.dev/v2/browser \
  --header 'Authorization: Bearer <token>'

200

{
  "success": true,
  "sessions": [
    {
      "id": "<string>",
      "cdpUrl": "<string>",
      "liveViewUrl": "<string>",
      "interactiveLiveViewUrl": "<string>",
      "streamWebView": true,
      "createdAt": "2023-11-07T05:31:56Z",
      "lastActivity": "2023-11-07T05:31:56Z"
    }
  ]
}

​

En-têtes

En-tête	Valeur
Authorization	Bearer <API_KEY>

​

Paramètres de requête

Paramètre	Type	Obligatoire	Description
status	string	Non	Filtre par statut de session : "active" ou "destroyed"

​

Réponse

Champ	Type	Description
success	boolean	Indique si la requête a réussi
sessions	array	Liste d’objets de session

​

Objet de session

Champ	Type	Description
id	string	Identifiant unique de la session
status	string	Statut actuel de la session ("active" ou "destroyed")
cdpUrl	string	URL WebSocket pour les connexions CDP
liveViewUrl	string	URL pour afficher la session en temps réel
interactiveLiveViewUrl	string	URL pour interagir avec la session en temps réel (clic, saisie, défilement)
createdAt	string	Horodatage ISO 8601 de la création de la session
lastActivity	string	Horodatage ISO 8601 de la dernière activité

​

Exemple de requête

curl -X GET "https://api.firecrawl.dev/v2/browser?status=active" \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY"

​

Exemple de réponse

{
  "success": true,
  "sessions": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "active",
      "cdpUrl": "wss://cdp-proxy.firecrawl.dev/cdp/550e8400-e29b-41d4-a716-446655440000",
      "liveViewUrl": "https://liveview.firecrawl.dev/550e8400-e29b-41d4-a716-446655440000",
      "interactiveLiveViewUrl": "https://liveview.firecrawl.dev/550e8400-e29b-41d4-a716-446655440000?interactive=true",
      "createdAt": "2025-06-01T12:00:00Z",
      "lastActivity": "2025-06-01T12:05:30Z"
    }
  ]
}

Autorisations

Authorization · string · header · requis

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

Paramètres de requête

status · enum<string>

Filtrer les sessions par statut

Options disponibles: active, destroyed

Réponse

200

application/json

Liste des sessions de navigateur

success · boolean

sessions · object[]

Show child attributes