List Interact Sessions

{ "success": true, "sessions": [ { "id": "<string>", "status": "active", "cdpUrl": "<string>", "liveViewUrl": "<string>", "interactiveLiveViewUrl": "<string>", "streamWebView": true, "createdAt": "2026-08-10T12:00:00Z", "lastActivity": "2026-08-10T12:00:00Z" } ] }

Headers#

Header	Value
`Authorization`	`Bearer <API_KEY>`

Query Parameters#

Parameter	Type	Required	Description
`status`	string	No	Filter by session status: `"active"` or `"destroyed"`

Response#

Field	Type	Description
`success`	boolean	Whether the request succeeded
`sessions`	array	List of session objects

Session Object#

Field	Type	Description
`id`	string	Unique session identifier
`status`	string	Current session status (`"active"` or `"destroyed"`)
`cdpUrl`	string	WebSocket URL for CDP connections
`liveViewUrl`	string	URL to watch the session in real time
`interactiveLiveViewUrl`	string	URL to interact with the session in real time (click, type, scroll)
`createdAt`	string	ISO 8601 timestamp of session creation
`lastActivity`	string	ISO 8601 timestamp of last activity

Example Request#

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

Example Response#

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

Are you an AI agent that needs a Firecrawl API key? See firecrawl.dev/agent-onboarding/SKILL.md for automated onboarding instructions.

Headers#

Query Parameters#

Response#

Session Object#

Example Request#

Example Response#

Authorization

Query parameters

Responses