Interact EndpointsGET/interact
Retrieve your standalone Interact sessions, optionally filtered by status.
| Header | Value |
|---|
Authorization | Bearer <API_KEY> |
| Parameter | Type | Required | Description |
|---|
status | string | No | Filter by session status: "active" or "destroyed" |
| Field | Type | Description |
|---|
success | boolean | Whether the request succeeded |
sessions | array | List of session objects |
| 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 |
curl -X GET "https://api.firecrawl.dev/v2/interact?status=active" \
-H "Authorization: Bearer $FIRECRAWL_API_KEY"
{
"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.