Chrome UX Report API
Aufruf
Felddaten echter Chrome-Nutzer für bis zu 10 URLs: TTFB, FCP, LCP, INP und CLS mit Bewertung, auf Wunsch mit Verlauf.
https://seorch.de/api/crux/?key=DEIN_KEY&urls=https://www.google.com&query=origin
Parameter
| Parameter | Pflicht | Bedeutung |
|---|---|---|
key | ja | Dein API Key, alternativ im Header X-API-Key |
urls | ja | Bis zu 10 URLs, getrennt durch Komma oder Zeilenumbruch |
query | nein | origin (Standard, ganze Domain) oder url (einzelne Seite) |
device | nein | all, phone, desktop oder tablet |
history | nein | 1 ergänzt den Verlauf je Metrik |
Antwort
| Feld | Bedeutung |
|---|---|
results | Je URL found, period_end, form_factors und metrics. Bei found: false hat Google keine Daten. |
metrics | Je Metrik p75, rating und die Anteile 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"
}
}
}
]
}
Fehler
Fehler kommen als JSON mit festem Code. Für alle APIs gelten missing_key und invalid_key (401), rate_limited (429) und fehlende oder ungültige Parameter (400). Außerdem bei dieser API: too_many_urls, upstream_error.
Limits
Pro Key gelten 10 Anfragen pro Minute und 500 pro Tag. Höhere Limits sind auf Anfrage möglich.