API de Website Rendering Instructions (POST)

Descripción generalLink to Descripción general

La API Website Rendering Instructions amplía las capacidades de renderizado headless con un parámetro browser_instructions, que permite controlar el desplazamiento y otras acciones del navegador antes de extraer el HTML renderizado. Esencial para activar contenido cargado de forma lazy, páginas con scroll infinito o simular navegación humana.

Tipos de instrucciones compatibles:

• scroll — desplaza la página un número preciso de píxeles
• scroll_to_bottom — desplaza automáticamente hasta el final de la página

Inicio rápidoLink to Inicio 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 respuestaLink to Campos de respuesta

NotasLink to Notas

• Este endpoint cuesta 2 créditos por solicitud
• Se aplica filtrado de dominio por razones de seguridad
• Las instrucciones se ejecutan secuencialmente; si una falla, las siguientes continúan
• Aumenta timeout cuando las duraciones acumuladas de las instrucciones sean significativas

Casos de uso principalesLink to Casos de uso principales

• Activar imágenes y secciones con scroll infinito cargadas en lazy loading antes de extraer contenido
• Simular comportamiento de desplazamiento humano para eludir la detección de bots en sitios JavaScript-intensivos
• Cargar contenido renderizado dinámicamente (reseñas, comentarios, tablas) que solo aparece tras interacción
• Automatizar la navegación de múltiples pasos en SPAs para alcanzar estados de página profundos