Skip to content
HALOWERK

Bildwerk

viewport sheet

Renders the HTML (or a fetched page with up to 3 inlined stylesheets) in a sandboxed headless Chrome context with scripts disabled and all network requests blocked, once per viewport: by default 360×800, 430×932, 768×1024 and 1024×768 with mobile emulation (meta viewport honoured), 1366×768 and 1920×1080 as desktop. For each viewport it measures layout width, scroll width and horizontal overflow, the innermost elements that stick out to the right (unless clipped by an overflow container),.

POST https://bild.halowerk.com/v1/viewport-sheet

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
htmlstringNoHTML of the page with inline or embedded CSS. External resources are not loaded. Give html or url.
urlstringNoPublic http(s) page, fetched once (robots.txt respected); up to 3 linked stylesheets are fetched and inlined.
viewportsarrayNoOwn viewports in CSS pixels (default: six from phone to desktop).
capture_heightintegerNoCapture the page top up to this height instead of only the visible viewport.
tile_widthintegerNoTile box size in sheet pixels (each screenshot is fitted into a square box).
columnsintegerNo
formatstringNo
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "html": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000000,
      "description": "HTML of the page with inline or embedded CSS. External resources are not loaded. Give html or url."
    },
    "url": {
      "type": "string",
      "format": "uri",
      "pattern": "^https?://",
      "maxLength": 2048,
      "description": "Public http(s) page, fetched once (robots.txt respected); up to 3 linked stylesheets are fetched and inlined."
    },
    "viewports": {
      "type": "array",
      "minItems": 1,
      "maxItems": 6,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "width",
          "height"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 30,
            "pattern": "^[A-Za-z0-9 ._-]+$"
          },
          "width": {
            "type": "integer",
            "minimum": 240,
            "maximum": 2560
          },
          "height": {
            "type": "integer",
            "minimum": 240,
            "maximum": 1600
          },
          "mobile": {
            "type": "boolean",
            "default": false
          }
        }
      },
      "description": "Own viewports in CSS pixels (default: six from phone to desktop)."
    },
    "capture_height": {
      "type": "integer",
      "minimum": 240,
      "maximum": 4000,
      "description": "Capture the page top up to this height instead of only the visible viewport."
    },
    "tile_width": {
      "type": "integer",
      "minimum": 120,
      "maximum": 480,
      "default": 300,
      "description": "Tile box size in sheet pixels (each screenshot is fitted into a square box)."
    },
    "columns": {
      "type": "integer",
      "minimum": 1,
      "maximum": 6,
      "default": 3
    },
    "format": {
      "type": "string",
      "enum": [
        "jpeg",
        "png"
      ],
      "default": "jpeg"
    }
  }
}

Open original schema

Published input example

{
  "html": "<!doctype html><html><head><meta name=\"viewport\" content=\"width=device-width\"><style>.grid{display:grid;grid-template-columns:repeat(3,300px);gap:10px}.grid div{background:#e5322d;height:80px}@media (max-width:700px){.grid{grid-template-columns:1fr}}</style></head><body><h1>Shop</h1><div class=\"grid\"><div></div><div></div><div></div></div></body></html>",
  "tile_width": 200,
  "columns": 3
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →