FeaturePOST /v1/performance

Performance & Sandbox

Measure FCP/LCP/CLS against a URL — or render HTML in an isolated sandbox, including a screenshot.

What you can do with performance and sandbox

Measure Core Web Vitals and timing metrics against a live URL — or render isolated HTML in a sandbox (with optional screenshot) without an external page.

FCP, LCP, CLS, TTFB, and resource counts
Console/page errors alongside metrics
Sandbox: HTML + optional resources, block_external
Sandbox screenshot for visual verification

API Call

editable

Request body

{'{'}

{'}'}

Performance: settle_ms and viewport. Sandbox: toggle screenshot and block_external.

Response

—

FCP ms

—

LCP ms

—

CLS

Endpoints & parameters

Choose an endpoint — below you'll see an example request and explanations for all relevant parameters.

POST /v1/performance

Performance metrics for a public URL.

Example request

json

{
  "url": "https://example.com",
  "width": 1280,
  "height": 720,
  "settle_ms": 500
}

Parameters

urlstring required
Target URL.
width / heightnumber
Viewport for measurement.
settle_ms / goto_timeout_msnumber
Settle and navigation timeouts.