Chrome UX Report API
Request
Field data from real Chrome users for up to 10 URLs: TTFB, FCP, LCP, INP and CLS with rating, optionally with history.
https://seorch.net/api/crux/?key=YOUR_KEY&urls=https://www.google.com&query=origin
Parameters
| Parameters | Required | Meaning |
|---|---|---|
key | yes | Your API key, alternatively in the X-API-Key header |
urls | yes | Up to 10 URLs, separated by comma or line break |
query | no | origin (default, whole domain) or url (single page) |
device | no | all, phone, desktop or tablet |
history | no | 1 adds the history per metric |
Response
| Field | Meaning |
|---|---|
results | For each URL found, period_end, form_factors and metrics. With found: false Google has no data. |
metrics | For each metric p75, rating and the shares good, needs_improvement, poor |
{
"api_version": 1,
"query": "origin",
"device": "all",
"results": [
{
"url": "https://www.google.com",
"found": true,
"period_end": "2026-10-24",
"form_factors": {
"tablet": 0.0134,
"desktop": 0.3055,
"phone": 0.681
},
"metrics": {
"lcp": {
"date": "2026-10-24",
"p75": 1194,
"good": 0.9232,
"needs_improvement": 0.0472,
"poor": 0.0296,
"rating": "good"
}
}
}
]
}Errors
Errors are returned as JSON with a fixed code. All APIs use missing_key and invalid_key (401), rate_limited (429) and missing or invalid parameters (400). Additionally for this API: too_many_urls, upstream_error.
Limits
Each key allows 10 requests per minute and 500 per day. Higher limits are available on request.
Contents