Query real-user Core Web Vitals for an origin or URL using the CrUX API

domain: developer.chrome.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Provision a Google Cloud API key with the Chrome UX Report API enabled
  2. POST to the single CrUX API endpoint with an origin or url identifier, optional formFactor, and desired metrics
  3. Read back the record's 28-day rolling-average metric histograms and percentiles
  4. Respect the 150 queries/minute per Google Cloud project rate limit, offered free of charge
  5. Handle empty/404-style responses for origins or URLs with insufficient real-user traffic to appear in CrUX

Known gotchas

Related routes

Use the CrUX API to retrieve field Core Web Vitals for a specific URL and compare against Good thresholds
developer.chrome.com · 5 steps · unrated
Pull real-user Core Web Vitals field data for a set of origins/URLs from the CrUX API and CrUX History API within Google's quota
developer.chrome.com · 6 steps · unrated
Query real-user Core Web Vitals data using the Chrome UX Report (CrUX) API
developer.chrome.com · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans