Skip to content
Gridlode
Docs · Reference

PageSpeed & Core Web Vitals Test

GET /v1/url/pagespeed3 credits / requestcache 15 min

Load a page in real headless Chrome (mobile or desktop emulation, as in Lighthouse) and measure it: TTFB, First Contentful Paint, Largest Contentful Paint (with the LCP element), Cumulative Layout Shift, Total Blocking Time from long tasks, DOMContentLoaded and load time. Also total transfer size and requests by type, the largest resources, third-party domains, render-blocking CSS/JS, image hints (oversized, legacy formats, not lazy-loaded, no dimensions), compression, caching and HTTP/2. Returns a 0-100 Lighthouse-style score, an A-F grade and graded findings with fixes. Respects robots.txt by default. Failed loads are not charged.

Query parameters

url
string · required
Public http(s) URL of the page to test.
device
string
Emulated device, as in Lighthouse: mobile (412x823 viewport, touch, 4x CPU slowdown) or desktop (1350x940). Network is not throttled.
Default: "mobile"
Allowed: mobile, desktop
wait_ms
integer
Keep measuring this long after the page settles, to catch late paints and layout shifts.
Default: 1500
respect_robots
boolean
Refuse URLs disallowed by the site's robots.txt.
Default: true
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

    curl "https://api.gridlode.com/v1/url/pagespeed?url=https%3A%2F%2Fexample.com%2F&device=desktop&wait_ms=500" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the PageSpeed & Core Web Vitals Test API page.