Microproduct data guidebeginner

Chrome UX Report API

Real-user Chrome experience metrics for building Core Web Vitals monitors from origin-level CrUX records.

Start the guide Open official source

At a glance

Difficulty
Beginner — comfortable for a first prototype
Size
Tiny · ≤0.01 GB
Formats
JSON
Access
API
API key
Required
Provider
Google
Updates
Daily
Data terms
Google APIs Terms of Service

From source to product signal

Test a product idea in four steps

The CrUX API returns origin-level p75 metrics such as LCP and INP. Start with one origin you are authorized to monitor. CrUX covers opted-in Chrome users, not synthetic tests, and small origins can be missing.

1

Check the setup

  • Python 3.10 or newer
  • A notebook environment such as Jupyter or Google Colab
  • A Google API key saved in the CRUX_API_KEY environment variable
2

Access the data

  1. 1.Enable the Chrome UX Report API in Google Cloud and save CRUX_API_KEY.
  2. 2.Read the query endpoint documentation.
  3. 3.Request metrics for one HTTPS origin.
Open official source
3

Run the Python example

Install the packages, then run the notebook cell.

python -m pip install pandas requests

import os
import pandas as pd
import requests

response = requests.post(
    "https://chromeuxreport.googleapis.com/v1/records:queryRecord",
    params={"key": os.environ["CRUX_API_KEY"]},
    json={"origin": "https://developer.chrome.com"},
    timeout=30,
)
response.raise_for_status()
record = pd.json_normalize(response.json())
print(record)
4

Test a useful signal

Read one origin's Core Web Vitals

Test whether CrUX can power a bounded real-user performance card.

  1. 01Confirm p75 LCP, INP, and CLS fields returned for the origin.
  2. 02Compare those p75 values to the published "good" thresholds.
  3. 03Explain that CrUX is opted-in Chrome field data and that small origins can be absent.

Dataset details

Google is a company source. Last verified 2026-08-18. Temporal coverage: rolling 28-day CrUX collection windows.

Theme

Technology & Cybersecurity

Domains

Web PerformanceSoftware

Data types

Aggregated DataTime Series

Tasks

Performance MonitoringOrigin ComparisonAlerting

Geography

Global

Formats

JSON

Provider

Google

Data terms

Google APIs Terms of Service