Lister les sessions Interact

Obtenir vos sessions Interact autonomes, avec possibilité de filtrer par statut.

GET /interact

Lister les sessions Interact

cURL

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

import requests

url = "https://api.firecrawl.dev/v2/interact"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.firecrawl.dev/v2/interact', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.firecrawl.dev/v2/interact",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.firecrawl.dev/v2/interact"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.firecrawl.dev/v2/interact")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.firecrawl.dev/v2/interact")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

200

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

{
  "error": "Payment required to access this resource."
}

​

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/interact?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"
    }
  ]
}

Êtes-vous un agent IA qui a besoin d’une clé API Firecrawl ? Consultez firecrawl.dev/agent-onboarding/SKILL.md pour obtenir les instructions d’intégration automatisée.

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

Options disponibles: active, destroyed

Réponse

200

application/json

Liste des sessions Interact

sessions · object[]

Show child attributes

success · boolean