Skip to content
Firecrawl Docs
Firecrawl Docs
Endpoints de interacción

Crear sesión de Interact

POST/interact

Inicia una sesión de navegador independiente de Interact que controlas con código (no requiere scraping previo).

CabeceraValor
AuthorizationBearer <API_KEY>
Content-Typeapplication/json
ParámetroTipoObligatorioValor predeterminadoDescripción
ttlnumberNo600Duración total de la sesión en segundos (30-3600)
activityTtlnumberNo300Segundos de inactividad antes de que la sesión se elimine (10-3600)
profileobjectNoHabilita el almacenamiento persistente entre sesiones. Consulta más abajo.
profile.namestringSí*Nombre del perfil (1-128 caracteres). Las sesiones con el mismo nombre comparten almacenamiento.
profile.saveChangesbooleanNotrueCuando es true, el estado del navegador se guarda de nuevo en el perfil al cerrar. Establécelo en false para cargar los datos existentes sin escribir. Solo se permite un proceso de guardado a la vez.
CampoTipoDescripción
successbooleanIndica si se creó la sesión
idstringIdentificador único de la sesión
cdpUrlstringURL de WebSocket para conexiones CDP
liveViewUrlstringURL para ver la sesión en tiempo real
interactiveLiveViewUrlstringURL para interactuar con la sesión en tiempo real (hacer clic, escribir, desplazarse)
expiresAtstringMomento en que la sesión expirará según el TTL
curl -X POST "https://api.firecrawl.dev/v2/interact" \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ttl": 120
  }'
{
  "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"
}

¿Eres un agente de IA que necesita una clave de API de Firecrawl? Consulta firecrawl.dev/agent-onboarding/SKILL.md para ver las instrucciones de incorporación automática.

Was this page helpful?Suggest editsRaise issue