# Créer une session Interact (/fr/api-reference/endpoint/browser-create)

<!-- agent-signals: reading_time_min: 4 · est_tokens: 1977 · 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>` |
| `Content-Type`  | `application/json` |

<div id="request-body">
  ## Corps de la requête [#corps-de-la-requête]
</div>

| Paramètre             | Type    | Obligatoire | Valeur par défaut | Description                                                                                                                                                                                               |
| --------------------- | ------- | ----------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ttl`                 | number  | Non         | 600               | Durée de vie totale de la session en secondes (30-3600)                                                                                                                                                   |
| `activityTtl`         | number  | Non         | 300               | Nombre de secondes d'inactivité avant la destruction de la session (10-3600)                                                                                                                              |
| `profile`             | object  | Non         | —                 | Active un stockage persistant d'une session à l'autre. Voir ci-dessous.                                                                                                                                   |
| `profile.name`        | string  | Oui\*       | —                 | Nom du profil (1-128 caractères). Les sessions portant le même nom partagent le stockage.                                                                                                                 |
| `profile.saveChanges` | boolean | Non         | `true`            | Lorsque `true`, l'état du navigateur est enregistré dans le profil à la fermeture. Définissez sur `false` pour charger les données existantes sans écriture. Un seul enregistreur est autorisé à la fois. |

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

| Champ                    | Type    | Description                                                                  |
| ------------------------ | ------- | ---------------------------------------------------------------------------- |
| `success`                | boolean | Indique si la session a bien été créée                                       |
| `id`                     | string  | Identifiant unique de la session                                             |
| `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 (clics, saisie, défilement) |
| `expiresAt`              | string  | Date d’expiration de la session en fonction du TTL                           |

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

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

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

```json
{
  "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",
  "interactiveLiveViewUrl": "https://liveview.firecrawl.dev/550e8400-e29b-41d4-a716-446655440000?interactive=true"
}
```

> Ê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.

`POST /interact`

Créer une session Interact

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "properties": {
            "activityTtl": {
              "description": "Temps en secondes avant la destruction de la session pour cause d’inactivité",
              "maximum": 3600,
              "minimum": 10,
              "type": "integer"
            },
            "profile": {
              "description": "Active le stockage persistant entre les sessions Interact. Les données enregistrées dans une session peuvent être chargées dans une session ultérieure en utilisant le même nom.",
              "properties": {
                "name": {
                  "description": "Nom du profil. Les sessions portant le même nom partagent le stockage.",
                  "maxLength": 128,
                  "minLength": 1,
                  "type": "string"
                },
                "saveChanges": {
                  "default": true,
                  "description": "Lorsque cette valeur est définie sur true, l’état du Browser est enregistré dans le profil à la fermeture. Définissez-la sur false pour charger les données existantes sans les enregistrer. Plusieurs sessions sans enregistrement sont autorisées, mais une seule session avec enregistrement à la fois.",
                  "type": "boolean"
                }
              },
              "required": [
                "name"
              ],
              "type": "object"
            },
            "streamWebView": {
              "default": true,
              "description": "Indique s’il faut diffuser une vue en direct du Browser",
              "type": "boolean"
            },
            "ttl": {
              "default": 300,
              "description": "Durée de vie totale de la session Interact, en secondes",
              "maximum": 3600,
              "minimum": 30,
              "type": "integer"
            }
          },
          "type": "object"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "cdpUrl": {
                "description": "URL WebSocket pour accéder au protocole Chrome DevTools",
                "type": "string"
              },
              "expiresAt": {
                "description": "Date d’expiration de la session selon le TTL",
                "format": "date-time",
                "type": "string"
              },
              "id": {
                "description": "Identifiant unique de la session",
                "type": "string"
              },
              "interactiveLiveViewUrl": {
                "description": "URL pour Interact avec la session Interact en temps réel (cliquer, saisir, faire défiler)",
                "type": "string"
              },
              "liveViewUrl": {
                "description": "URL pour consulter la session Interact en temps réel",
                "type": "string"
              },
              "success": {
                "type": "boolean"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "Session Interact créée avec succès"
    },
    "402": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "error": {
                "example": "Payment required to access this resource.",
                "type": "string"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "Paiement requis"
    }
  }
}
```