Interagir com uma página extraída

Use este endpoint para continuar interagindo com o mesmo estado do navegador iniciado a partir de um scraping anterior. É necessário fornecer code ou prompt — não ambos.

POST /v2/scrape/{jobId}/interact gerencia todo o ciclo de vida:

Se ainda não existir uma sessão do navegador para este job de scraping, o Firecrawl cria uma no mesmo estado da página do scraping original.
Quando code é fornecido, o Firecrawl o executa no sandbox do navegador. Quando prompt é fornecido, um agente de IA automatiza a tarefa usando linguagem natural.
Chamadas posteriores para POST /interact no mesmo jobId reutilizam o mesmo estado ativo do navegador.

Quando terminar, chame DELETE /v2/scrape/{jobId}/interact para encerrar a sessão.

Parâmetros do caminho#

Parâmetro	Tipo	Obrigatório	Descrição
`jobId`	string (UUID)	Sim	O ID do job de scraping em `data.metadata.scrapeId` na resposta de scraping

Corpo da requisição#

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
`code`	string	Não	—	Código a ser executado no sandbox do navegador (1–100.000 caracteres). Obrigatório se `prompt` não estiver definido.
`prompt`	string	Não	—	Tarefa em linguagem natural para o agente de IA (1–10.000 caracteres). Obrigatório se `code` não estiver definido.
`language`	string	Não	`"node"`	Um de `"python"`, `"node"` ou `"bash"`. Usado apenas com `code`.
`timeout`	number	Não	`30`	Tempo limite de execução em segundos (1–300).
`origin`	string	Não	—	Rótulo de origem opcional usado para telemetria.

resposta#

Campo	Tipo	Descrição
`success`	boolean	Indica se a execução foi concluída sem erros
`cdpUrl`	string	URL WebSocket bruta do Chrome DevTools Protocol (CDP) para a sessão do navegador. Conecte-se diretamente com Playwright, Puppeteer ou qualquer cliente CDP
`liveViewUrl`	string	URL de visualização em tempo real somente leitura da sessão do navegador
`interactiveLiveViewUrl`	string	URL de visualização em tempo real interativa (os usuários podem controlar o navegador)
`output`	string	Resposta final do agente de IA (presente apenas ao usar `prompt`)
`stdout`	string	Saída padrão da execução do código
`result`	string	Valor de retorno — valor da última expressão no Node.js, instantâneo final da página para `prompt`
`stderr`	string	Saída de erro padrão
`exitCode`	number	Código de saída da execução (`0` = sucesso)
`killed`	boolean	Indica se a execução foi encerrada devido ao tempo limite
`error`	string	Mensagem de erro (presente apenas em caso de falha)

Exemplo de requisição (Código)#

curl -X POST "https://api.firecrawl.dev/v2/scrape/550e8400-e29b-41d4-a716-446655440000/interact" \  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "code": "const title = await page.title(); JSON.stringify({ title });",    "language": "node",    "timeout": 30  }'

Exemplo de resposta (Código)#

{  "success": true,  "cdpUrl": "wss://browser.firecrawl.dev/...",  "liveViewUrl": "https://liveview.firecrawl.dev/...",  "interactiveLiveViewUrl": "https://liveview.firecrawl.dev/...",  "stdout": "",  "result": "{\"title\":\"Example Domain\"}",  "stderr": "",  "exitCode": 0,  "killed": false}

Exemplo de requisição (Prompt)#

curl -X POST "https://api.firecrawl.dev/v2/scrape/550e8400-e29b-41d4-a716-446655440000/interact" \  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "prompt": "Find the pricing section and tell me the price of the Pro plan",    "timeout": 60  }'

Exemplo de resposta (Prompt)#

{  "success": true,  "cdpUrl": "wss://browser.firecrawl.dev/...",  "liveViewUrl": "https://liveview.firecrawl.dev/...",  "interactiveLiveViewUrl": "https://liveview.firecrawl.dev/...",  "output": "The Pro plan costs $49/month and includes unlimited scrapes, priority support, and custom integrations.",  "stdout": "...",  "result": "...",  "stderr": "",  "exitCode": 0,  "killed": false}

Códigos de erro#

Status	Descrição
`402`	Créditos insuficientes para uma sessão do navegador
`403`	O job de scraping pertence a outra equipe
`404`	Job de scraping não encontrado
`409`	Contexto de replay indisponível — refaça o scraping e tente novamente
`410`	A sessão do navegador já foi encerrada
`429`	Número máximo de sessões simultâneas do navegador atingido
`502`	Falha no serviço de navegador ou na execução do agente de IA
`503`	Recurso de navegador não configurado (apenas self-hosted)

Para detalhes de uso e exemplos, consulte o guia do recurso Interact.