Waterfall

GET /api/v1/waterfall

A request-by-request load waterfall for any page — every resource with its load timing and render-blocking status, plus the key page-timing milestones. See exactly what's slowing a page down.

Query parameters

NameTypeDescription
url requiredstringThe page to load.
device optionalstringmobile (default) or desktop.
limit optionalintegerMax requests to return. Default 100, max 500.

Request

Response

200 · application/json
  1. {
  2. "url": "https://example.com",
  3. "strategy": "mobile",
  4. "fetchedUrl": "https://example.com/",
  5. "totalRequests": 24,
  6. "returned": 24,
  7. "totalTransferBytes": 482140,
  8. "requests": [
  9. {
  10. "url": "https://example.com/",
  11. "resourceType": "Document",
  12. "mimeType": "text/html",
  13. "statusCode": 200,
  14. "startTime": 0,
  15. "endTime": 220,
  16. "duration": 220,
  17. "transferSize": 12840,
  18. "resourceSize": 51200
  19. }
  20. ]
  21. }

Response fields

FieldTypeDescription
strategystringThe device strategy used: mobile or desktop.
fetchedUrlstringThe final URL that was actually loaded (after redirects).
totalRequestsintegerTotal number of network requests seen during the load.
returnedintegerNumber of requests in this response after applying limit.
totalTransferBytesintegerSum of transfer sizes across all requests, in bytes.
requests[]arrayEach request: url, resourceType, mimeType, statusCode, startTime/endTime/duration (ms relative to navigation start), transferSize and resourceSize (bytes).
Waterfall data comes from a real browser load, so this endpoint is slower than the static checks. See Errors.
← Previous
Lighthouse