# Lister les sessions Interact (/fr/api-reference/endpoint/browser-list)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 1376 · updated: 2026-07-30 -->
Related: [Recherche](/fr/api-reference/endpoint/search.md), [Retour sur la recherche](/fr/api-reference/endpoint/search-feedback.md), [Scrape](/fr/api-reference/endpoint/scrape.md), [Scrape par lot](/fr/api-reference/endpoint/batch-scrape.md), [Obtenir l’état d’une extraction par lot](/fr/api-reference/endpoint/batch-scrape-get.md), [Annuler une extraction par lots](/fr/api-reference/endpoint/batch-scrape-delete.md)

<div id="headers">
  ## En-têtes [#en-têtes]
</div>

| En-tête         | Valeur             |
| --------------- | ------------------ |
| `Authorization` | `Bearer <API_KEY>` |

<div id="query-parameters">
  ## Paramètres de requête [#paramètres-de-requête]
</div>

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

<div id="response">
  ## Réponse [#réponse]
</div>

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

<div id="session-object">
  ### Objet de session [#objet-de-session]
</div>

| 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é                                 |

<div id="example-request">
  ### Exemple de requête [#exemple-de-requête]
</div>

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

<div id="example-response">
  ### Exemple de réponse [#exemple-de-réponse]
</div>

```json
{
  "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"
    }
  ]
}
```

> Êtes-vous un agent IA qui a besoin d'une clé API Firecrawl ? Consultez [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) pour obtenir les instructions d'intégration automatisée.

`GET /interact`

Lister les sessions Interact

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "description": "Filtrer les sessions par état",
      "in": "query",
      "name": "status",
      "required": false,
      "schema": {
        "enum": [
          "active",
          "destroyed"
        ],
        "type": "string"
      }
    }
  ],
  "responses": {
    "200": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "sessions": {
                "items": {
                  "properties": {
                    "cdpUrl": {
                      "type": "string"
                    },
                    "createdAt": {
                      "format": "date-time",
                      "type": "string"
                    },
                    "id": {
                      "type": "string"
                    },
                    "interactiveLiveViewUrl": {
                      "description": "URL pour Interact avec la session Interact en temps réel (cliquer, saisir, faire défiler)",
                      "type": "string"
                    },
                    "lastActivity": {
                      "format": "date-time",
                      "type": "string"
                    },
                    "liveViewUrl": {
                      "type": "string"
                    },
                    "status": {
                      "enum": [
                        "active",
                        "destroyed"
                      ],
                      "type": "string"
                    },
                    "streamWebView": {
                      "type": "boolean"
                    }
                  },
                  "type": "object"
                },
                "type": "array"
              },
              "success": {
                "type": "boolean"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "Liste des sessions Interact"
    },
    "402": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "error": {
                "example": "Payment required to access this resource.",
                "type": "string"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "Paiement requis"
    }
  }
}
```