Skip to main content
POST
Interactúa con la sesión del navegador asociada a un trabajo de scrape
Usa este endpoint para seguir interactuando con el mismo estado del navegador inicializado a partir de un scrape anterior. Debes proporcionar code o prompt, pero no ambos. POST /v2/scrape/{jobId}/interact gestiona el ciclo de vida completo:
  1. Si todavía no existe una sesión del navegador para este trabajo de scrape, Firecrawl crea una con el mismo estado de la página que el scrape original.
  2. Cuando se proporciona code, Firecrawl lo ejecuta en el sandbox del navegador. Cuando se proporciona prompt, un agente de IA automatiza la tarea al utilizar lenguaje natural.
  3. Las llamadas posteriores a POST /interact con el mismo jobId reutilizan el mismo estado activo del navegador.
Cuando hayas terminado, llama a DELETE /v2/scrape/{jobId}/interact para detener la sesión.

Parámetros de ruta

Request Body

respuesta

solicitud de ejemplo (Code)

Respuesta de ejemplo (código)

Solicitud de ejemplo (Prompt)

respuesta de ejemplo (Prompt)

Códigos de error

Para obtener información detallada sobre el uso con ejemplos, consulta la guía de la función Interact.

Autorizaciones

Authorization
string
header
requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parámetros de ruta

jobId
string<uuid>
requerido

El ID de trabajo de scrape

Cuerpo

application/json
code
string
requerido

Código que se ejecutará en el entorno aislado del navegador vinculado al scrape

Required string length: 1 - 100000
language
enum<string>
predeterminado:node

Lenguaje del código que se ejecutará. Usa node para JavaScript o bash para comandos de CLI de agent-browser.

Opciones disponibles:
python,
node,
bash
timeout
integer
predeterminado:30

timeout de ejecución en segundos

Rango requerido: 1 <= x <= 300
origin
string

Etiqueta de origen opcional usada para la telemetría de ejecución

Respuesta

Código ejecutado correctamente

success
boolean
stdout
string | null

salida estándar de la ejecución del código

result
string | null

salida estándar (alias de stdout)

stderr
string | null

salida de error estándar de la ejecución del código

exitCode
integer | null

Código de salida del proceso ejecutado

killed
boolean

Indica si el proceso se finalizó debido a un timeout

error
string | null

Mensaje de error si el código generó una excepción