API Website Rendering Instructions (POST)

Visão geralLink to Visão geral

A API Website Rendering Instructions estende as capacidades de renderização headless com um parâmetro browser_instructions, permitindo controlar a rolagem e outras ações do navegador antes de extrair o HTML renderizado. Essencial para acionar conteúdo carregado de forma lazy, páginas com scroll infinito ou simular navegação humana.

Tipos de instruções suportados:

• scroll — rola a página um número preciso de pixels
• scroll_to_bottom — rola automaticamente até o final da página

Início rápidoLink to Início rápido

POST https://api.piloterr.com/v2/website/rendering
Content-Type: application/json

{
  "query": "https://www.comparably.com/companies/airbus",
  "wait_for": "#ng-state",
  "browser_instructions": [
    { "type": "scroll", "x": 0, "y": 4115, "wait_time_s": 5 }
  ]
}

ParâmetrosLink to Parâmetros

Campos de respostaLink to Campos de resposta

NotasLink to Notas

• Este endpoint custa 2 créditos por requisição
• Filtragem de domínio é aplicada por razões de segurança
• As instruções são executadas sequencialmente; se uma falhar, as seguintes continuam
• Aumente timeout quando as durações acumuladas das instruções forem significativas

Casos de uso principaisLink to Casos de uso principais

• Acionar imagens e seções com scroll infinito carregadas em lazy loading antes de extrair conteúdo
• Simular comportamento de rolagem humana para contornar a detecção de bots em sites JavaScript-intensivos
• Carregar conteúdo renderizado dinamicamente (avaliações, comentários, tabelas) que só aparece após interação
• Automatizar navegação de múltiplas etapas em SPAs para atingir estados de página profundos