# Listar sessões do Interact (/pt-BR/api-reference/endpoint/browser-list)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 1374 · updated: 2026-07-30 -->
Related: [Pesquisa](/pt-BR/api-reference/endpoint/search.md), [Feedback de busca](/pt-BR/api-reference/endpoint/search-feedback.md), [Raspar](/pt-BR/api-reference/endpoint/scrape.md), [Raspar em lote](/pt-BR/api-reference/endpoint/batch-scrape.md), [Obter status do scrape em lote](/pt-BR/api-reference/endpoint/batch-scrape-get.md), [Cancelar raspagem em lote](/pt-BR/api-reference/endpoint/batch-scrape-delete.md)

<div id="headers">
  ## Cabeçalhos [#cabeçalhos]
</div>

| Cabeçalho       | Valor              |
| --------------- | ------------------ |
| `Authorization` | `Bearer <API_KEY>` |

<div id="query-parameters">
  ## Parâmetros de query [#parâmetros-de-query]
</div>

| Parâmetro | Tipo   | Obrigatório | Descrição                                                 |
| --------- | ------ | ----------- | --------------------------------------------------------- |
| `status`  | string | Não         | Filtra pelo status da sessão: `"active"` ou `"destroyed"` |

<div id="response">
  ## Resposta [#resposta]
</div>

| Campo      | Tipo    | Descrição                               |
| ---------- | ------- | --------------------------------------- |
| `success`  | boolean | Indica se a requisição foi bem-sucedida |
| `sessions` | array   | Lista de objetos de sessão              |

<div id="session-object">
  ### Objeto de sessão [#objeto-de-sessão]
</div>

| Campo                    | Tipo   | Descrição                                                              |
| ------------------------ | ------ | ---------------------------------------------------------------------- |
| `id`                     | string | Identificador único da sessão                                          |
| `status`                 | string | Status atual da sessão (`"active"` ou `"destroyed"`)                   |
| `cdpUrl`                 | string | URL de WebSocket para conexões CDP                                     |
| `liveViewUrl`            | string | URL para assistir à sessão em tempo real                               |
| `interactiveLiveViewUrl` | string | URL para interagir com a sessão em tempo real (clicar, digitar, rolar) |
| `createdAt`              | string | Carimbo de data e hora ISO 8601 da criação da sessão                   |
| `lastActivity`           | string | Carimbo de data e hora ISO 8601 da última atividade                    |

<div id="example-request">
  ### Exemplo de requisição [#exemplo-de-requisição]
</div>

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

<div id="example-response">
  ### Exemplo de resposta [#exemplo-de-resposta]
</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"
    }
  ]
}
```

> Você é um agente de IA que precisa de uma chave de API do Firecrawl? Consulte [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) para ver instruções de integração automatizada.

`GET /interact`

Listar sessões de interação

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "description": "Filtrar sessões por status",
      "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 para interagir com a sessão de interação em tempo real (clicar, digitar, rolar)",
                      "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": "Lista de sessões de interação"
    },
    "402": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "error": {
                "example": "Payment required to access this resource.",
                "type": "string"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "Pagamento necessário"
    }
  }
}
```