Passer au contenu principal
GET
/
browser
Lister les sessions de navigateur
curl --request GET \
  --url https://api.firecrawl.dev/v2/browser \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "sessions": [
    {
      "id": "<string>",
      "status": "active",
      "cdpUrl": "<string>",
      "liveViewUrl": "<string>",
      "streamWebView": true,
      "createdAt": "2023-11-07T05:31:56Z",
      "lastActivity": "2023-11-07T05:31:56Z"
    }
  ]
}

​
En-têtes

En-têteValeur
AuthorizationBearer <API_KEY>

​
Paramètres de requête

ParamètreTypeObligatoireDescription
statusstringNonFiltre par statut de session : "active" ou "destroyed"

​
Réponse

ChampTypeDescription
successbooleanIndique si la requête a réussi
sessionsarrayListe d’objets de session

​
Objet de session

ChampTypeDescription
idstringIdentifiant unique de la session
statusstringStatut actuel de la session ("active" ou "destroyed")
cdpUrlstringURL WebSocket pour les connexions CDP
liveViewUrlstringURL pour afficher la session en temps réel
createdAtstringHorodatage ISO 8601 de la création de la session
lastActivitystringHorodatage 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",
      "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

Liste des sessions de navigateur

​
success
boolean
​
sessions
object[]