API Website Rendering Instructions (POST)

Vue d'ensembleLink to Vue d'ensemble

L'API Website Rendering Instructions étend les capacités de rendu headless avec un paramètre browser_instructions, permettant de contrôler le défilement et d'autres actions du navigateur avant d'extraire le HTML rendu. Indispensable pour déclencher du contenu chargé en lazy loading, les pages à défilement infini, ou pour simuler une navigation humaine.

Types d'instructions supportés :

• scroll: fait défiler la page d'un nombre précis de pixels
• scroll_to_bottom: fait défiler automatiquement jusqu'au bas de la page

Démarrage rapideLink to Démarrage rapide

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 }
  ]
}

ParamètresLink to Paramètres

Champs de réponseLink to Champs de réponse

NotesLink to Notes

• Cet endpoint coûte 2 crédits par requête
• Un filtrage de domaine est appliqué. Contactez le support pour whitelister votre domaine
• Les instructions s'exécutent séquentiellement ; si l'une échoue, les suivantes continuent
• Augmentez timeout si les durées cumulées des instructions sont significatives

Cas d'usage principauxLink to Cas d'usage principaux

• Déclencher le lazy loading d'images et les sections en défilement infini avant d'extraire le contenu
• Simuler un défilement humain pour contourner la détection de bots sur les sites JavaScript-intensifs
• Charger du contenu rendu dynamiquement (avis, commentaires, tableaux) n'apparaissant qu'après interaction
• Automatiser la navigation multi-étapes sur des SPAs pour atteindre des états de page profonds